Felo API PlatformFelo API Platform
Zurück zu den Modellen

Hy Image 3.5 Preview API

Tencent Hy Image 3.5 Preview ist ein Vorschaumodell für professionelle Bilderzeugung und -bearbeitung mit Text- und Bildeingabe.

Tencent Hy Image 3.5 Preview ist ein Vorschaumodell von Tencent für die professionelle Bilderzeugung und -bearbeitung. Es verarbeitet Texteingaben sowie bis zu fünf Referenzbilder pro Anfrage und gibt Bilder in den Auflösungen 1K, 2K und 4K mit verschiedenen Seitenverhältnissen aus. Das Modell unterstützt mehrsprachige Textdarstellung und Typografie sowie mehrstufige, konversationelle Bearbeitung auf Basis des vorherigen Kontexts. Die API nutzt das Chat/Messages-Protokoll mit Mehrbild-Eingabe, mehrstufigem Bearbeitungskontext und Chain-of-Thought-Umschreibung.

Besonders geeignet ist Hy Image 3.5 Preview für Werbevisuals, Infografiken, UI-Design, Fotoretusche, Porträtverschönerung, Wissenskarten, kommerzielle Poster, Episoden-Storyboards, Film- und Fernsehmaterialien, kreative Illustration, Markenvisuals und E-Commerce-Materialien. Tencent positioniert das Modell als kosteneffiziente Lösung für professionelle Bildgestaltung statt als Benchmark-Spitzenreiter. Hervorgehoben werden das starke chinesische Semantikverständnis und ein realistischer Stil, der für kommerzielle Lieferungen geeignet ist.

Laut Tencent liegt die Gesamtleistung im internen Test etwa 30 % über der vorherigen Generation. Das Modell ist als Vorschauversion verfügbar und noch keine finale stabile GA-Version; Verhalten, Limits und Preisgestaltung können sich ändern. Die Angabe zur Leistungssteigerung basiert auf Tenscots eigener Bewertung und muss unabhängig überprüft werden. Die automatische Größenauswahl kann bei verschiedenen Läufen unterschiedliche Ausrichtungen erzeugen, weshalb in der Produktion eine manuelle Größeneinstellung empfohlen wird. Preisgestaltung und Stabilität für 4K sind in der Vorschauphase unklar.

Aktualisiert:

MODELL-ID

hy-image-v3.5-preview
Eingabe
text / image
Ausgabe
image

Highlights

  • Text- und Bildeingabe mit bis zu fünf Referenzbildern
  • Ausgaben in 1K, 2K und 4K
  • Mehrsprachige Textdarstellung und Typografie
  • Mehrstufige konversationelle Bearbeitung
  • Realistischer Stil für kommerzielle Lieferungen
  • Starkes chinesisches Semantikverständnis

Anbieter

1 Anbieter

Vergleichen Sie die API-Preise verschiedener Anbieter. Wählen Sie einen Anbieter aus, um alle Kosten und Bedingungen zu sehen.

Anbieter · Preisdetails
Verfügbarkeit

Schnellstart

Senden Sie einen Bildauftrag, fragen Sie den Status ab und speichern Sie die Bilder. Die Beispiele verwenden curl und die Python-3-Standardbibliothek.

POST https://openapi.felo.ai/api/v1/images/generations

1API-Schlüssel hinterlegen

Erstellen Sie einen Schlüssel in Ihrem Konto bei der Felo API Platform und legen Sie ihn als Umgebungsvariable ab.

export FELO_API_KEY="YOUR_API_KEY"

2Erste Anfrage senden

Optionale Werte hängen vom Modell ab und werden hier nicht vorgegeben. Prüfen Sie sie im Playground. Felder stehen neben model und prompt, ohne input-Hülle.

curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -o created.json \
  -d '{
  "prompt": "A studio product photo of a ceramic coffee cup on warm linen, soft morning light",
  "model": "hy-image-v3.5-preview"
}'

3Aufgabe abfragen

Die Antwort enthält task_id. Bei queued oder running alle 3 Sekunden abfragen; bei succeeded, failed oder interrupted stoppen. Maximale Wartezeit: 30 Minuten. Mit created.json können Sie denselben Auftrag ohne erneute Übermittlung weiter abfragen.

python3 - <<'PY'
import json, os, time
from pathlib import Path
from urllib.parse import quote
from urllib.request import Request, urlopen

task = json.loads(Path("created.json").read_text())
task_id = task["task_id"]
url = "https://openapi.felo.ai/api/v1/images/generations/" + quote(task_id, safe="")
headers = {"Authorization": "Bearer " + os.environ["FELO_API_KEY"]}
deadline = time.monotonic() + 1800

while task["status"] in ("queued", "running"):
    if time.monotonic() >= deadline:
        raise TimeoutError(f"Keep task_id={task_id} to resume polling")
    time.sleep(3)
    with urlopen(Request(url, headers=headers), timeout=60) as response:
        task = json.load(response)
    if task.get("task_id") != task_id or task.get("kind") != "image":
        raise ValueError("Unexpected task response")
    print(task["status"])

if task["status"] != "succeeded":
    raise RuntimeError(task.get("error") or task["status"])
if not task.get("outputs"):
    raise ValueError("Task succeeded without image outputs")
Path("task.json").write_text(json.dumps(task))
print("Saved task.json")
PY

4Ausgabe herunterladen

Nach Erfolg outputs aus task.json speichern. Unterstützt werden HTTPS-URLs, URL-Objekte und b64_json. Signierte URLs zeitnah herunterladen; dafür ist kein API-Schlüssel nötig.

python3 - <<'PY'
import base64, json
from pathlib import Path
from urllib.request import urlopen

task = json.loads(Path("task.json").read_text())
if task.get("status") != "succeeded" or not task.get("outputs"):
    raise ValueError("No completed image outputs")
extensions = {"image/png": ".png", "image/jpeg": ".jpg", "image/webp": ".webp", "image/gif": ".gif", "image/avif": ".avif"}

for index, output in enumerate(task["outputs"], 1):
    item = output if isinstance(output, dict) else {}
    url = output if isinstance(output, str) else item.get("url") or item.get("unsigned_url")
    mime = item.get("media_type") or "image/png"
    if url and url.startswith("https://"):
        with urlopen(url, timeout=60) as response:
            data = response.read()
            mime = response.headers.get_content_type()
    elif url and url.startswith("data:image/") and ";base64," in url:
        header, encoded = url.split(",", 1)
        mime = header[5:].split(";", 1)[0]
        data = base64.b64decode(encoded, validate=True)
    elif item.get("b64_json"):
        data = base64.b64decode(item["b64_json"], validate=True)
    else:
        raise ValueError("Unrecognized image output")
    path = Path(f"image-{index}" + extensions.get(mime, ".bin"))
    path.write_bytes(data)
    print(path)
PY
input_references

Zum Bearbeiten die Beispiel-URL durch Ihre HTTPS-Bild-URL oder eine Base64-Bild-data-URL ersetzen. Einmal senden und dieselben Abfrage- und Speicherschritte verwenden.

curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -o created.json \
  -d '{
  "prompt": "Keep the product and framing. Replace the background with a sunlit marble countertop.",
  "model": "hy-image-v3.5-preview",
  "input_references": [
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/product.png"
      }
    }
  ]
}'

Unterstützte Parameter

  • n
  • seed
  • size
  • resolution
  • aspect_ratio
  • input_references

Lieber die vollständige Referenz?

API-Referenz →

Häufige Fragen

Was ist Hy Image 3.5 Preview?

Tencent Hy Image 3.5 Preview ist ein Vorschaumodell von Tencent für die professionelle Bilderzeugung und -bearbeitung. Es verarbeitet Texteingaben sowie bis zu fünf Referenzbilder pro Anfrage und gibt Bilder in den Auflösungen 1K, 2K und 4K mit verschiedenen Seitenverhältnissen aus. Das Modell unterstützt mehrsprachige Textdarstellung und Typografie sowie mehrstufige, konversationelle Bearbeitung auf Basis des vorherigen Kontexts. Die API nutzt das Chat/Messages-Protokoll mit Mehrbild-Eingabe, mehrstufigem Bearbeitungskontext und Chain-of-Thought-Umschreibung. Besonders geeignet ist Hy Image 3.5 Preview für Werbevisuals, Infografiken, UI-Design, Fotoretusche, Porträtverschönerung, Wissenskarten, kommerzielle Poster, Episoden-Storyboards, Film- und Fernsehmaterialien, kreative Illustration, Markenvisuals und E-Commerce-Materialien. Tencent positioniert das Modell als kosteneffiziente Lösung für professionelle Bildgestaltung statt als Benchmark-Spitzenreiter. Hervorgehoben werden das starke chinesische Semantikverständnis und ein realistischer Stil, der für kommerzielle Lieferungen geeignet ist. Laut Tencent liegt die Gesamtleistung im internen Test etwa 30 % über der vorherigen Generation. Das Modell ist als Vorschauversion verfügbar und noch keine finale stabile GA-Version; Verhalten, Limits und Preisgestaltung können sich ändern. Die Angabe zur Leistungssteigerung basiert auf Tenscots eigener Bewertung und muss unabhängig überprüft werden. Die automatische Größenauswahl kann bei verschiedenen Läufen unterschiedliche Ausrichtungen erzeugen, weshalb in der Produktion eine manuelle Größeneinstellung empfohlen wird. Preisgestaltung und Stabilität für 4K sind in der Vorschauphase unklar.

Wie wird die Nutzung abgerechnet?

Ihre Rechnung hängt vom genutzten Anbieter, seinen Preisen und Ihrer Nutzung ab. Längere Eingaben oder andere Bedingungen können andere Preise haben.

Welche Eingaben unterstützt Hy Image 3.5 Preview?

Das Modell akzeptiert Texteingaben und Bild eingaben mit bis zu fünf Referenzbildern pro Anfrage. Die Ausgabe erfolgt als Bild.

Welche Ausgabauflösungen und Seitenverhältnisse sind möglich?

Es werden Ausgabauflösungen von 1K, 2K und 4K sowie mehrere Seitenverhältnisse unterstützt.

Für welche Aufgaben ist das Modell geeignet?

Es eignet sich für Werbevisuals, Infografiken, UI-Design, Fotoretusche, Porträtverschönerung, kommerzielle Poster, Storyboards, Film- und Fernsehmaterialien sowie E-Commerce-Materialien.

Wie unterscheidet sich Hy Image 3.5 Preview von der vorherigen Generation?

Tencent gibt an, dass die Gesamtleistung im internen Test etwa 30 % über der vorherigen Generation liegt. Diese Angabe basiert auf Tenscots eigener Bewertung und muss unabhängig überprüft werden.

Unterstützt das Modell mehrstufige Bearbeitung?

Ja, es unterstützt mehrstufige konversationelle Erstellung und Bearbeitung auf Basis des vorherigen Kontexts. Die API nutzt dafür das Chat/Messages-Protokoll mit mehrstufigem Bearbeitungskontext.

Verwandte Modelle