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": "Describe this image",
"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

Пример запроса:
GET /api/public/check?api_key=your-api-key&content_id=550e8400-e29b-41d4-a716-446655440

Ответ при успехе:
{
"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 | generation-limit-exceeded | Превышен лимит генерации
| 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://your-domain.com/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://your-domain.com/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
}'

Проверка статуса
curl "https://your-domain.com/api/public/check?api_key=your-api-key&content_id=550e8400-e29b-41d4-a716-446655440000"


Генерация с изображением (Gemini)
curl -X POST "https://your-domain.com/api/public/gemini-2.0-flash-exp/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 действуют обычные правила использования сервиса.

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