Felo API PlatformFelo API Platform
Retour aux modèles

Hy Image 3.5 Preview API

Hy Image 3.5 Preview est un modèle de génération et d'édition d'images de Tencent, conçu pour la création visuelle professionnelle avec un bon rapport coût-performance.

Hy Image 3.5 Preview est un modèle de Tencent spécialisé dans la génération d'images à partir de texte et l'édition d'images, capable de traiter jusqu'à 5 images de référence par requête. Il prend en charge la création et l'édition conversationnelles multi-tours en s'appuyant sur le contexte précédent, ainsi que plusieurs ratios d'aspect et des résolutions de sortie de 1K, 2K et 4K. Le rendu typographique multilingue et le réalisme des textures (peau, tissu, éclairage de contour) en font un outil adapté aux livrables commerciaux. L'API utilise le protocole Chat/Messages avec entrée multi-images, contexte d'édition multi-tours et réécriture par chaîne de pensée.

Ce modèle est positionné comme une solution rentable pour la création d'images professionnelles plutôt que comme un leader de classements. Il se distingue par une forte compréhension sémantique du chinois et un style réaliste adapté aux livraisons commerciales. Selon les tests internes de Tencent, sa capacité globale serait environ 30 % supérieure à celle de la génération précédente, un chiffre qui reste à vérifier indépendamment. Tencent indique que ses performances sont comparables à Seedream 5.0 Pro et légèrement meilleures que Nano-Banana Pro et Qwen-Image-3.0 Pro.

Il est particulièrement adapté aux visuels publicitaires, aux infographies, à la conception d'interfaces, à la retouche photo, aux portraits embellis, aux fiches de connaissances, aux affiches commerciales, aux storyboards d'épisodes, aux supports audiovisuels, à l'illustration créative, aux visuels de marque et aux supports e-commerce. Le temps de génération médian est d'environ 15,5 secondes ; une image carrée en 2K prend environ 20 secondes, et une édition environ 23 secondes. Attention toutefois : il s'agit d'une version preview, non stable, dont le comportement, les limites et le prix peuvent évoluer ; la sélection automatique de taille peut produire des orientations différentes selon les exécutions, et il est conseillé de définir manuellement la taille en production. Le prix et la stabilité en 4K ne sont pas encore clairs.

Mis à jour:

ID DU MODÈLE

hy-image-v3.5-preview
Entrée
text / image
Sortie
image

Points clés

  • Génération texte-image et édition image-image
  • Jusqu'à 5 images de référence par requête
  • Création et édition multi-tours
  • Résolutions 1K, 2K et 4K
  • Rendu typographique multilingue
  • API Chat/Messages avec chaîne de pensée

Fournisseurs

1 fournisseurs

Comparez les prix des API entre fournisseurs. Sélectionnez un fournisseur pour voir tous les tarifs et conditions.

Fournisseur · Détails des tarifs
Disponibilité

Démarrage rapide

Envoyez une tâche image, consultez son état, puis enregistrez les images. Les exemples utilisent curl et la bibliothèque standard de Python 3.

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

1Configurer votre clé API

Créez une clé depuis votre compte Felo API Platform et définissez-la comme variable d'environnement.

export FELO_API_KEY="YOUR_API_KEY"

2Effectuer votre première requête

Les valeurs facultatives dépendent du modèle et ne sont pas prédéfinies ici. Vérifiez-les dans Playground. Les champs sont au même niveau que model et prompt, sans enveloppe input.

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"
}'

3Interroger la tâche

La soumission renvoie task_id. Interrogez toutes les 3 secondes pendant queued ou running ; arrêtez à succeeded, failed ou interrupted. Attente maximale : 30 minutes. Gardez created.json pour reprendre sans soumettre une nouvelle tâche.

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

4Télécharger la sortie

Après réussite, enregistrez outputs depuis task.json : URL HTTPS, objets URL ou b64_json. Téléchargez rapidement les URL signées. Le téléchargement des images ne nécessite pas de clé API.

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

Pour modifier une image, remplacez l’URL par votre URL HTTPS ou une data URL d’image en base64. Soumettez une fois, puis suivez les mêmes étapes de consultation et d’enregistrement.

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"
      }
    }
  ]
}'

Paramètres pris en charge

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

Besoin de la référence complète ?

Référence API →

Questions fréquentes

Qu'est-ce que Hy Image 3.5 Preview?

Hy Image 3.5 Preview est un modèle de Tencent spécialisé dans la génération d'images à partir de texte et l'édition d'images, capable de traiter jusqu'à 5 images de référence par requête. Il prend en charge la création et l'édition conversationnelles multi-tours en s'appuyant sur le contexte précédent, ainsi que plusieurs ratios d'aspect et des résolutions de sortie de 1K, 2K et 4K. Le rendu typographique multilingue et le réalisme des textures (peau, tissu, éclairage de contour) en font un outil adapté aux livrables commerciaux. L'API utilise le protocole Chat/Messages avec entrée multi-images, contexte d'édition multi-tours et réécriture par chaîne de pensée. Ce modèle est positionné comme une solution rentable pour la création d'images professionnelles plutôt que comme un leader de classements. Il se distingue par une forte compréhension sémantique du chinois et un style réaliste adapté aux livraisons commerciales. Selon les tests internes de Tencent, sa capacité globale serait environ 30 % supérieure à celle de la génération précédente, un chiffre qui reste à vérifier indépendamment. Tencent indique que ses performances sont comparables à Seedream 5.0 Pro et légèrement meilleures que Nano-Banana Pro et Qwen-Image-3.0 Pro. Il est particulièrement adapté aux visuels publicitaires, aux infographies, à la conception d'interfaces, à la retouche photo, aux portraits embellis, aux fiches de connaissances, aux affiches commerciales, aux storyboards d'épisodes, aux supports audiovisuels, à l'illustration créative, aux visuels de marque et aux supports e-commerce. Le temps de génération médian est d'environ 15,5 secondes ; une image carrée en 2K prend environ 20 secondes, et une édition environ 23 secondes. Attention toutefois : il s'agit d'une version preview, non stable, dont le comportement, les limites et le prix peuvent évoluer ; la sélection automatique de taille peut produire des orientations différentes selon les exécutions, et il est conseillé de définir manuellement la taille en production. Le prix et la stabilité en 4K ne sont pas encore clairs.

Comment l'usage est-il facturé ?

Votre facture dépend du fournisseur utilisé, de ses tarifs et de votre usage. Des entrées plus longues ou d'autres conditions peuvent avoir des tarifs différents.

Quels types d'entrées le modèle accepte-t-il ?

Hy Image 3.5 Preview accepte du texte et des images en entrée, et produit des images en sortie. Il peut traiter jusqu'à 5 images de référence par requête.

Quelles sont les résolutions de sortie disponibles ?

Le modèle propose des résolutions de sortie de 1K, 2K et 4K, ainsi que plusieurs ratios d'aspect.

Le modèle prend-il en charge l'édition conversationnelle multi-tours ?

Oui, il prend en charge la création et l'édition conversationnelles multi-tours basées sur le contexte précédent. L'API utilise le protocole Chat/Messages avec un contexte d'édition multi-tours et une réécriture par chaîne de pensée.

À quoi sert principalement ce modèle ?

Il est conçu pour la création d'images professionnelles : visuels publicitaires, infographies, conception d'interfaces, retouche photo, affiches commerciales, storyboards, illustrations créatives et supports e-commerce.

Quelle est la différence avec les modèles concurrents ?

Tencent indique que ses capacités sont comparables à Seedream 5.0 Pro et légèrement supérieures à Nano-Banana Pro et Qwen-Image-3.0 Pro. Il se distingue par une forte compréhension sémantique du chinois et un style réaliste adapté aux livrables commerciaux.

Quelles sont les limites de cette version preview ?

Il s'agit d'une version preview, non stable : le comportement, les limites et le prix peuvent changer. La sélection automatique de taille peut donner des orientations différentes selon les exécutions ; il est conseillé de définir manuellement la taille en production. Le prix et la stabilité en 4K ne sont pas encore clairs.

Modèles liés