Изображения

Эндпоинты генерации и редактирования изображений в формате OpenAI Images. Доступные модели (DALL·E 3, GPT-Image, Seedream и др.) зависят от канала — ниже перечислены общие поля.

Генерация изображения

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

Запрос

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

Тело запроса

Параметр	Тип	Обязательно	Описание
model	string	Нет	По умолчанию dall-e-2; также dall-e-3, gpt-image-1 и др.
prompt	string	Да	Описание изображения — до 4000 символов на DALL·E 3
n	integer	Нет	Количество изображений 1–10 (DALL·E 3 поддерживает только 1)
size	string	Нет	Разрешение: 1024x1024 / 1792x1024 / 1024x1792 (DALL·E 3); 256/512/1024x1024 (DALL·E 2); auto/1024x1536/1536x1024 (GPT-Image)
quality	string	Нет	standard / hd (DALL·E 3); low/medium/high/auto (GPT-Image)
response_format	string	Нет	url (по умолчанию) или b64_json (GPT-Image всегда возвращает b64)
style	string	Нет	Только DALL·E 3: vivid / natural
seed	integer	Нет	Случайное зерно

Ответ

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

При response_format: "b64_json" в data[].b64_json содержатся данные изображения в Base64. Результаты url указывают на временное расположение в апстриме — своевременно скачайте и перезалейте их на собственное хранилище.

Редактирование изображения

POST /v1/images/edits

Загрузите исходное изображение как multipart/form-data и измените его по промпту (поддерживается в 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"

Поле	Тип	Обязательно	Описание
image	file	Да	Исходное изображение (png/jpeg/webp; GPT-Image принимает несколько image[])
prompt	string	Да	Инструкция по редактированию
mask	file	Нет	Маска, прозрачные области которой подлежат редактированию (DALL·E 2)
model	string	Нет	gpt-image-1 / dall-e-2
n / size / quality	-	Нет	То же, что и в эндпоинте генерации

Устаревшие эндпоинты

POST /v1/images/variations (вариации изображения, DALL·E 2) и POST /v1/edits (устаревший путь) тоже проксируются — параметры те же, что и выше. Используйте их только для старых кодовых баз.

Совет

Модели вроде Nano Banana (изображения Gemini) тоже работают через формат OpenAI — просто укажите соответствующее имя в model; нераспознанные параметры передаются в апстрим без изменений.