Перейти к основному содержанию

Documentation Index

Fetch the complete documentation index at: https://docs.runblob.io/llms.txt

Use this file to discover all available pages before exploring further.

Base URL: https://platform.runblob.io

​
POST /v1/chatgpt-images/generate

Создаёт задачу генерации изображения из текстового описания через ChatGPT Image 2.
​
prompt
string
обязательно
Текстовое описание изображения (1–4000 символов)
​
aspect_ratio
string
Соотношение сторон. Варианты: 1:1 (квадрат), 4:3 (ландшафт), 3:4 (портрет), 16:9 (широкоэкранный), 9:16 (вертикальный), 21:9 (ультраширокий), 4:5 (соцсети, портрет)Необязательно — если не задано, модель сама выберет лучшее соотношение под промпт.
​
images
array
Массив до 4 изображений для генерации по референсам. Каждый элемент может быть:
  • HTTP/HTTPS URL (например, "https://example.com/image.jpg")
  • Base64 с MIME-типом (например, "data:image/jpeg;base64,/9j/4AAQSkZJRg...")
  • Base64 без префикса (декодируется как JPEG по умолчанию)
​
callback_url
string
URL webhook для уведомлений о готовности
Соотношение сторон: необязательный параметр. Если не передан, модель сама выбирает оптимальный вариант под промпт.
curl -X POST https://platform.runblob.io/v1/chatgpt-images/generate -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{
  "prompt": "A futuristic city with flying cars, neon lights, cyberpunk style"
}'

​
Ответ

{
  "task_uuid": "dc62d83d-1953-4bca-8554-222679a7a4a9",
  "status": "pending",
  "price": "0.0123"
}
​
task_uuid
string
UUID задачи генерации для проверки статуса
​
status
string
Начальный статус, всегда "pending"
​
price
string
Сумма списания в USD
Генерация обычно занимает 1–3 минуты. Используйте task_uuid для проверки статуса или настройте webhooks.Эндпоинт статуса: GET /v1/chatgpt-images/generations/{task_uuid}

​
Режимы генерации

API поддерживает 2 режима генерации:

​
1. Text-to-Image

Генерация изображения только из текста (без референсов). 
{
  "prompt": "A futuristic cyberpunk city with neon lights"
}

​
2. Генерация по референсам

Генерация изображения с использованием до 4 референсных изображений.
  • Макс. изображений: 4 на запрос
  • Форматы: JPEG, PNG, WEBP
  • Источники изображений:
    • HTTP/HTTPS URL (сервер сохраняет как ссылку)
    • Base64 с MIME-типом: data:image/jpeg;base64,...
    • Base64 без префикса (декодируется как JPEG)
{
  "prompt": "Combine these images into a beautiful collage",
  "images": [
    "https://example.com/ref1.jpg",
    "data:image/png;base64,iVBORw0KGgoAAAANS...",
    "/9j/4AAQSkZJRg..."  // Base64 without prefix
  ]
}

​
Варианты формата изображений

HTTP/HTTPS URL:
  • Сервер сохраняет как ссылку (не скачивает)
  • Должен быть публично доступен
  • Пример: "https://example.com/image.jpg"
Полная Base64-строка:
  • Включает префикс MIME-типа
  • Пример: "data:image/jpeg;base64,/9j/4AAQSkZJRg..."
  • Пример: "data:image/png;base64,iVBORw0KGgoAAAANS..."
Plain Base64:
  • Без префикса, декодируется как JPEG по умолчанию
  • Пример: "/9j/4AAQSkZJRg..."
  • Автоматически загружается в S3

​
Ошибки в ответе

400 Bad Request: 
{
  "detail": "Validation error: images format invalid"
}
402 Payment Required: 
{
  "detail": "INSUFFICIENT_CREDITS"
}
500 Internal Server Error: 
{
  "detail": "OPENAI_DECLINED"
}
503 Service Unavailable: 
{
  "detail": "Maintenance"
}