Chad Image API
Генерируйте картинки в своих программах и сервисах
Как это работает?

Вы отправляете HTTP POST запросы (см. пример ниже) и получаете JSON-ответ с текстом от бота.


Не поддерживается работа с вашими чатами и шаблонами. Запросы, отправленные через API, не будут видны в списке ваших чатов в интерфейсе Chad.

Тарификация точно такая же, как для запросов на сайте:
  • Для личных аккаунтов: потраченные слова будут списываться из текущего оплаченного пакета;
  • Для корпоративных аккаунтов: будет списываться сумма за потраченные токены по текущему тарифу.
Как начать?

  1. Нужен активный оплаченный аккаунт (корпоративный или личный, подойдёт любой платный тариф).
  2. В личном кабинете нужно перейти в меню "Для разработчиков" и получить ваш персональный API-ключ.
  3. Отправляйте запросы, используя любой удобный вам язык программирования, и получайте сообщение с ответом.

Нужно отправлять POST-запросы на адрес, в зависимости от желаемой модели:
https://ask.chadgpt.ru/api/public/{model}/imagine

Например: https://ask.chadgpt.ru/api/public/flux-1-schnell/imagine

В теле запроса нужно указать параметры запроса в формате JSON (см. пример ниже).
В теле ответа будет JSON-строка с ответом от бота или кодом ошибки (см. ниже).
Общие принципы

  • Все запросы используют HTTP POST для генерации изображений
  • Для проверки статуса генерации используется HTTP GET
  • Ответы возвращаются в формате JSON
  • Временные метки представлены в формате ISO 8601 (UTC)
  • Все текстовые поля автоматически очищаются от пробелов
Модели генерации

imagen-4: Базовая модель Imagen 4
imagen-4-fast: Быстрая версия Imagen 4
imagen-4-ultra: Ультра версия Imagen 4
mj-5.2: Midjourney 5.2
mj-6: Midjourney 6
mj-6.1: Midjourney 6.1
mj-7: Midjourney 7
gemini-2.5-fl ash-image: Gemini 2.5 Flash Image (Nano Banana)
flux-1-schnell: Flux 1 Schnell
flux-1.1-pro: Flux 1.1 Pro
flux-1.1-pro-ultra: Flux 1.1 Pro Ultra
flux-kontext-pro: Flux Kontext Pro
flux-kontext-max: Flux Kontext Max
flux-kontext-multi: Flux Kontext Multi
recraft-v3-svg: Recraft V3 SVG
gpt-img-low: GPT Image Low
gpt-img-medium: GPT Image Medium
gpt-img-high: GPT Image High
seedream-4: Seedream 4
seededit-3: Seededit 3
Endpoints

Генерация изображений
POST https://ask.chadgpt.ru/api/public/{model}/imagine
Запускает генерацию изображения с использованием указанной модели.

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

Все модели поддерживают базовые параметры:
- api_key (string, обязательный): API ключ для аутентификации
- prompt (string, обязательный): Текстовое описание изображения (1-1000 символов)

Специфичные параметры по моделям:

Imagen модели

{
"api_key": "your-api-key",
"prompt": "A beautiful sunset over mountains",
"aspect_ratio": "1:1"
}

aspect_ratio: "1:1" | "16:9" | "9:16" | "4:3" | "3:4" (по умолчанию: "1:1")

Midjourney модели

{
"api_key": "your-api-key",
"prompt": "A futuristic cityscape",
"aspect_ratio": "1:1",
"chaos": 50,
"quality": "high",
"seed": 12345,
"style": "anime"
}

Дополнительные параметры:

- aspect_ratio: `"1:1"` | `"3:2"` | `"2:3"` | `"16:9"` | `"9:16"`
- chaos (integer, 0-100): Уровень хаотичности
- no (string): Негативные промпты
- quality (string): Качество генерации
- seed (integer, 0-4000000): Сид для воспроизводимости
- stop (integer, 10-100): Процент остановки
- style (string): Стиль
- stylize (integer, ≥0): Уровень стилизации
- tile (boolean): Включить тайлинг
- weird (integer, ≥0): Уровень странности

Gemini модели

{
"api_key": "your-api-key",
"prompt": "Добавь кота",
"image_urls": ["https://example.com/image.jpg"],
"image_base64s": ["data:image/jpeg;base64,..."]
}

Дополнительные параметры:

- image_urls (array, max 5): Список URL изображений
- image_base64s (array, max 5): Список base64 изображений

Flux модели

Flux 1 Schnell:

{
"api_key": "your-api-key",
"prompt": "A magical forest",
"aspect_ratio": "1:1",
"images": 1
}

Flux 1.1 Pro Ultra:

{
"api_key": "your-api-key",
"prompt": "A cyberpunk city",
"aspect_ratio": "16:9",
"seed": 12345,
"is_raw": false
}

Flux Kontext модели:

{
"api_key": "your-api-key",
"prompt": "Transform this image",
"aspect_ratio": "1:1",
"seed": 12345,
"image_url": "https://example.com/image.jpg"
}

Stable Diffusion

{
"api_key": "your-api-key",
"prompt": "A steampunk robot",
"aspect_ratio": "1:1",
"images": 1
}

Дополнительные параметры:

- aspect_ratio: `"1:1"` | `"9:7"` | `"7:9"` | `"19:13"` | `"7:4"` | `"4:7"` | `"12:5"` | `"5:12"`
- images: 1 | 4 (количество изображений)

DALL-E модели

{
"api_key": "your-api-key",
"prompt": "A cute robot",
"aspect_ratio": "1:1"
}

aspect_ratio: `"1:1"` | `"16:9"` | `"9:16"`

Seedream

{
"api_key": "your-api-key",
"prompt": "A fantasy landscape",
"aspect_ratio": "16:9",
"size_preset": "2K",
"image_urls": ["https://example.com/image.jpg"]
}

Дополнительные параметры:

- aspect_ratio: `"1:1"` | `"4:3"` | `"3:4"` | `"16:9"` | `"9:16"` | `"3:2"` | `"2:3"` | `"21:9"`
- size_preset: `"1K"` | `"2K"` | `"4K"`
- image_urls (array, max 5): Список URL изображений

Seededit

{
"api_key": "your-api-key",
"prompt": "Make this image more colorful",
"seed": 12345,
"guidance_scale": 7.5,
"image_url": "https://example.com/image.jpg"
}

Дополнительные параметры:

- seed (integer, 0-4000000): Сид для воспроизводимости
- guidance_scale (float, 1.0-10.0): Масштаб направленности
- image_url (string): URL изображения
- image_base64 (string): Base64 изображения

Примечание: Необходимо указать либо `image_url`, либо `image_base64`, но не оба одновременно.

Ответ при успехе:

{
"status": "starting",
"content_id": "550e8400-e29b-41d4-a716-446655440000",
"created_at": "2024-01-15T10:30:00Z",
"input": {
"prompt": "A beautiful sunset over mountains",
"aspect_ratio": "1:1",
"img_count": 1
},
"model": "imagen-4"
}

Ответ при ошибке:

{
"status": "failed",
"error_code": "IMG-001",
"error_message": "invalid-api-key"
}

Проверка статуса генерации

GET https://ask.chadgpt.ru/api/public/check

Проверяет статус генерации изображения.

Параметры запроса:
api_key (string, обязательный): API ключ для аутентификации
content_id (string, обязательный): ID контента, полученный из ответа imagine

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

{
"api_key": "your-api-key",
"content_id": "550e8400-e29b-41d4-a716-446655440000"
}

Ответ при успехе:
{
"status": "completed",
"created_at": "2024-01-15T10:35:00Z",
"started_at": "2024-01-15T10:30:00Z",
"completed_at": "2024-01-15T10:32:00Z",
"output": [
"https://storage.example.com/generated-image-1.jpg",
"https://storage.example.com/generated-image-2.jpg"
]
}

Возможные статусы:

- pending: Генерация в процессе
- completed: Генерация завершена успешно
- failed: Генерация завершилась с ошибкой
- cancelled: Генерация отменена

Ответ при ошибке:

{
"status": "failed",
"error_code": "IMG-007",
"error_message": "invalid-api-key"
}
Коды ошибок

Imagine API ошибки

Код

Сообщение

Описание

IMG-001

invalid-api-key

Неверный или отсутствующий API ключ

IMG-002

no-permission

Пользователь заблокирован

IMG-003

payment-required

Требуется оплата

IMG-004

service-unavailable

Сервис недоступен

IMG-005

generation-failed

Ошибка генерации

IMG-006

internal-server-error

Внутренняя ошибка сервера

IMG-011

empty-prompt

Пустой промпт

IMG-013

invalid-image-base64

Неверный формат base64 изображения

IMG-014

image-too-large

Изображение слишком большое

IMG-015

upload-failed

Ошибка загрузки

IMG-016

no-image-provided

Изображение не предоставлено


Check API ошибки

Код

Сообщение

Описание

IMG-007

invalid-api-key

Неверный или отсутствующий API ключ

IMG-008

content-not-found

Контент не найден

IMG-009

unknown-error

Неизвестная ошибка

IMG-010

internal-server-error

Внутренняя ошибка сервера

IMG-012

invalid-content-id-format

Неверный формат content_id

HTTP статус коды

- `200`: Успешный ответ
- `400`: Неверные параметры запроса
- `401`: Неавторизованный запрос (неверный API ключ)
- `403`: Доступ запрещен (недостаточно прав)
- `500`: Внутренняя ошибка сервера

Ограничения

- Максимальная длина промпта: 1000 символов
- Максимальное количество изображений в массиве: 5 (для большинства моделей)
- Максимальный размер изображения: 2048x2048 пикселей
- Поддерживаемые форматы изображений: JPEG, PNG, WebP

Примеры использования
Простая генерация изображения

curl -X POST "https://ask.chadgpt.ru/api/public/imagen-4/imagine" \
-H "Content-Type: application/json" \
-d '{
"api_key": "your-api-key",
"prompt": "A beautiful sunset over mountains",
"aspect_ratio": "16:9"
}'

Генерация с дополнительными параметрами (Midjourney)
curl -X POST "https://ask.chadgpt.ru/api/public/mj-6/imagine" \
-H "Content-Type: application/json" \
-d '{
"api_key": "your-api-key",
"prompt": "A futuristic cityscape, cyberpunk style",
"aspect_ratio": "16:9",
"quality": "high",
"chaos": 30,
"seed": 12345
}'

Генерация с изображением (Gemini)
curl -X POST "https://ask.chadgpt.ru/api/public/gemini-2.5-fl ash-image/imagine" \
-H "Content-Type: application/json" \
-d '{
"api_key": "your-api-key",
"prompt": "Describe what you see in this image",
"image_urls": ["https://example.com/image.jpg"]
}'
Популярные вопросы
При использовании API действуют обычные правила использования сервиса.

Не осуществляем поддержку и консультации по вашему коду или по интеграции в сторонние сервисы/программы.