Image à image

POST /v3/generation/image-to-image

Générez une nouvelle image à partir d’une image de référence.

Paramètres de la demande

En-têtes de demande

Paramètre	Tapez	Obligatoire	Par défaut	Descriptif
Content-Type	chaîne	Oui	-	`application/json`
Authorization	chaîne	Oui	-	`Bearer {api_key}`

Corps de la demande

Paramètre	Tapez	Obligatoire	Par défaut	Descriptif
input	chaîne	Oui	-	Image de référence. Prend en charge `file_token`, une image URL ou `task_id`
inputs	chaîne[]	Non	-	Liste de plusieurs images de référence. Les modèles `seedream` prennent en charge jusqu’à 4 images et les modèles `banana` prennent en charge jusqu’à 10 images. Vous pouvez référencer une image spécifique dans `prompt` en utilisant `[image number]`
prompt	chaîne	Requis sous condition	-	Instruction d’édition d’images. Obligatoire lorsque `template` n’est pas spécifié
model	chaîne	Non	`seedream_v5`	Modèle d’image. Valeurs prises en charge : `seedream_v5`, `banana`, `banana_pro`, `banana2`, `chat_image_1`, `chat_image_1.5`, `chat_image_2`, `chat_image_2.5_flare`, `chat_image_2.5_sunburst`
quality	chaîne	Non	`low`	Niveau de qualité. Uniquement `chat_image_2` (`low`, `medium`, `high`) et `chat_image_2.5_flare` / `chat_image_2.5_sunburst` (plus `xhigh`, `max`). Omis équivaut à `low` ; `auto` n’est pas pris en charge. `high`/`xhigh`/`max` coûtent plus de crédits.
background	chaîne	Non	-	Gestion de l’arrière-plan. Uniquement `chat_image_2.5_flare` / `chat_image_2.5_sunburst` : `auto`, `opaque`, `transparent`. Avec d’autres modèles, la valeur est ignorée et non rejetée. `transparent` exige `output_format=png` (JPEG n’a pas de canal alpha).
template	chaîne	Non	-	Nom du modèle. Valeurs prises en charge : `asset_extraction`, `character_completion`, `t_pose`, `head_extraction`, `3d_enhance`, `variants`, `print_clay`, `figure`
t_pose	booléen	Non	`false`	Convertir en pose en T
sketch_to_render	booléen	Non	`false`	Convertir une esquisse en image rendue

Exemples de demande

curl -X POST https://openapi.tripo3d.ai/v3/generation/image-to-image \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {api_key}" \
  -d '{
    "input": "https://example.com/reference.png",
    "prompt": "Replace the background with a starry sky",
    "model": "seedream-v4"
  }'

import requests

url = "https://openapi.tripo3d.ai/v3/generation/image-to-image"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
}
payload = {
    "input": "https://example.com/reference.png",
    "prompt": "Replace the background with a starry sky",
    "model": "seedream-v4"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

const url = "https://openapi.tripo3d.ai/v3/generation/image-to-image";

const response = await fetch(url, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
  },
  body: JSON.stringify({
    input: "https://example.com/reference.png",
    prompt: "Replace the background with a starry sky",
    model: "seedream-v4"
  })
});

const data = await response.json();
console.log(data);

Réponse

Réponse réussie

JSON

{
  "code": 0,
  "data": {
    "task_id": "task_abc123"
  }
}

Champs de réponse

Paramètre	Tapez	Descriptif
code	entier	Code d’état. `0` indique le succès
data.task_id	chaîne	Identifiant de tâche unique utilisé pour interroger la progression et les résultats de la génération

Codes d’erreur

Code d’état HTTP	Code d’erreur	Descriptif	Recommandation
429	2000	Limite de génération dépassée	Réduisez la fréquence des demandes et réessayez plus tard
400	2002	Paramètre de requête non pris en charge	Vérifier les noms des paramètres du corps de la requête et les plages de valeurs
400	2003	Le fichier d’entrée est vide	Confirmez que `input` pointe vers une ressource d’image valide
400	2004	Type de fichier non pris en charge	Utilisez un format d’image pris en charge (PNG, JPEG, WebP)
400	2008	L’entrée viole la politique relative au contenu	Révisez l’image ou l’invite d’entrée et supprimez les descriptions qui ne respectent pas les règles.
403	2010	Crédits insuffisants	Ajoutez des crédits et réessayez
400	2015	Version du modèle obsolète	Mettez à niveau `model` vers une version actuellement prise en charge