Справочник API

Изображения: сразу в ответе

Пока ни одна модель это не поддерживает

Сейчас ни одна модель из каталога моделей не поддерживает этот маршрут. Страница оставлена для справки.

POST/v1/images/generations

Синхронная генерация изображений для моделей, поддерживающих этот маршрут, одним запросом в формате OpenAI. В ответе — итоговые URL изображений.

#Параметры запроса

modelstringобязательно
Модель изображений, поддерживающая этот синхронный маршрут. Модели, работающие только через задачи, его отклоняют — используйте /v1/images/tasks.
promptstringобязательно
Что нарисовать.
nintegerнеобязательно
Количество изображений (стоимость умножается на их число).
sizestringнеобязательно
Предустановленное соотношение сторон, например "16:9", — так размер задаётся у большинства моделей изображений; точные значения указаны в карточке модели. Некоторые старые модели принимают и WIDTHxHEIGHT.
resolutionstringнеобязательно
Уровень разрешения результата, например "1K", "2K" или "4K", если он указан в карточке модели, — тоже влияет на ценовой уровень.
qualitystringнеобязательно
Уровень качества у провайдера (например, standard / hd) — тоже влияет на ценовой уровень.
response_formatstringнеобязательно
"url" (по умолчанию) или "b64_json" для байтов прямо в ответе.

Цены по уровням

size, quality и duration определяют тарифицируемый уровень — точная цена каждого уровня указана в карточке модели, а за неудачные вызовы средства возвращаются автоматически.

#Связанные ошибки

422 unprocessable_entityПровайдер отклонил значения параметров, переданные шлюзом (например, неподдерживаемый размер или длительность).
401Bearer-токен недействителен или отсутствует. На этом пути error.code нет — ориентируйтесь на статус.
402 insufficient_user_quotaБаланса кошелька не хватает на предварительно резервируемую сумму.
429Ограничение частоты для ключа. Тело пустое; дождитесь Retry-After. Если же в ответе 429 есть insufficient_user_quota, это дневной лимит расходов.
503 model_not_foundНеизвестная модель, или сейчас её не обслуживает ни один исправный канал.

Полная таблица кодов ошибок →

#Пример запроса

curl https://www.aisplice.store/v1/images/generations \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_SYNC_IMAGE_MODEL",
    "prompt": "A cyberpunk skyline at dusk, neon rain",
    "size": "1:1"
  }'

#Ответ

response.json

{
  "created": 1720000000,
  "data": [{"url": "https://…"}]
}

Проблема не решена?

Пришлите нам ID запроса или текст ошибки, и мы разберёмся.

НазадMessages (формат Anthropic)ДалееИзображения: асинхронные задачи