cicora.ai
Русский
Спецификация APIИзображения

Изображения

Создавайте изображения через единый маршрут и выбирайте параметры по возможностям конкретной модели.

Справочник интеграции: выбирайте параметры и доступные возможности из API-настроек аккаунта и каталога модели для своего окружения.

Создайте генерацию

Запрос содержит model, prompt и только применимые параметры артефакта: размер, соотношение сторон, формат или число результатов.

Не используйте текстовую модель как идентификатор изображения: выбирайте модель по модальности каталога.

Image generation request
bash
curl --request POST https://cicora.ai/api/v1/images \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "google/gemini-2.5-flash-image",
    "prompt": "A precise editorial illustration of a delivery route at dusk",
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "n": 1
  }'

Референсы и редактирование

  • Передавайте референсные изображения в input_references только в форме, поддержанной выбранной моделью.
  • Image-to-image и редактирование используют тот же маршрут /images вместе с исходным референсом и текстовой инструкцией.
  • Проверяйте mime-type, размер и права на входной файл до отправки.

Получение артефакта

В совместимом ответе читайте data[].b64_json как байты изображения; media_type может уточнять формат. Сохраняйте метаданные вместе с prompt и моделью.

Не публикуйте частичный результат как финальный. При потоковой выдаче различайте черновое событие и завершённый артефакт.

Дальше