Images

Points de terminaison de texte vers image et d'édition d'image au format Images d'OpenAI. Les modèles disponibles (DALL·E 3, GPT-Image, Seedream, etc.) varient selon le canal — les champs ci-dessous sont les plus courants.

Générer une image

POST /v1/images/generations

RequestREQUEST

POSThttps://test.kailin.com.cn/v1/images/generations

The returned `url` is temporary — re-host promptly. b64_json mode returns large payloads and may render slowly.

API KeyStored only in your browser, never uploaded

Body (JSON){ "model": "dall-e-3", "prompt": "A cyberpunk city at night, neon lights, reflections after rain", "size": "1024x1024" }

ResponseRESPONSE

Fill in the request and hit Send — the response shows up here

Requête

curl https://test.kailin.com.cn/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-token" \
  -d '{
    "model": "dall-e-3",
    "prompt": "A cyberpunk city at night, neon lights, reflections after rain",
    "n": 1,
    "size": "1024x1792"
  }'

Corps de la requête

Paramètre	Type	Obligatoire	Description
model	string	Non	dall-e-2 par défaut ; également dall-e-3, gpt-image-1, etc.
prompt	string	Oui	Description de l'image — jusqu'à 4000 caractères sur DALL·E 3
n	integer	Non	Nombre d'images, de 1 à 10 (DALL·E 3 n'accepte que 1)
size	string	Non	Résolution : 1024x1024 / 1792x1024 / 1024x1792 (DALL·E 3) ; 256/512/1024x1024 (DALL·E 2) ; auto/1024x1536/1536x1024 (GPT-Image)
quality	string	Non	standard / hd (DALL·E 3) ; low/medium/high/auto (GPT-Image)
response_format	string	Non	url (défaut) ou b64_json (GPT-Image renvoie toujours du b64)
style	string	Non	DALL·E 3 uniquement : vivid / natural
seed	integer	Non	Graine aléatoire

Réponse

{
  "created": 1730000000,
  "data": [
    {
      "url": "https://oss.example.com/img/abc.png",
      "revised_prompt": "A cyberpunk city at night…"
    }
  ]
}

Avec response_format: "b64_json", data[].b64_json contient les données de l'image en Base64. Les résultats url pointent vers un emplacement amont temporaire — téléchargez-les et réhébergez-les rapidement.

Modifier une image

POST /v1/images/edits

Téléversez l'image source en multipart/form-data et modifiez-la via un prompt (pris en charge par GPT-Image / DALL·E 2) :

curl https://test.kailin.com.cn/v1/images/edits \
  -H "Authorization: Bearer sk-your-token" \
  -F "model=gpt-image-1" \
  -F "prompt=Replace the background with a seaside at dusk" \
  -F "image=@/path/to/input.png"

Champ	Type	Obligatoire	Description
image	file	Oui	Image source (png/jpeg/webp ; GPT-Image accepte plusieurs image[])
prompt	string	Oui	Instruction d'édition
mask	file	Non	Masque dont les zones transparentes sont modifiables (DALL·E 2)
model	string	Non	gpt-image-1 / dall-e-2
n / size / quality	-	Non	Identiques au point de terminaison de génération

Points de terminaison historiques

POST /v1/images/variations (variations d'image, DALL·E 2) et POST /v1/edits (chemin historique) sont également proxifiés — les paramètres sont les mêmes que ci-dessus. Réservez-les aux anciennes bases de code.

Astuce

Des modèles comme Nano Banana (images Gemini) fonctionnent aussi via le format OpenAI — il suffit de définir model sur le nom correspondant ; les paramètres non reconnus sont transmis tels quels à l'amont.