Ресурсы для разработчиков

Документация API Qwen-Image-2512

Интегрируйте модель Qwen-Image-2512 AI от Alibaba в свои приложения. Генерируйте высококачественные изображения из текстовых описаний через простой REST API.

1

Аутентификация

API Qwen-Image-2512 использует аутентификацию Bearer Token. Передавайте свой API-ключ в заголовке запроса.

Аутентификация
Authorization: Bearer sk-your-api-key-here

Храните свой API-ключ в безопасности. Не используйте его в клиентском коде.

Цены

ТипСтоимостьОписание
Текст в изображение5 кредитовГенерация изображений на основе текстовых описаний с помощью Qwen-Image-2512 AI.
2

Создать задачу

POSThttps://qwen-image-2512.org/api/generate
Асинхронная генерация

Цены

Каждая генерация изображения стоит 5 кредитов.

Запуск задачи генерации. API немедленно возвращает task_id, который используется для получения результата.

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

ПараметрТипОбязательноОписание
promptstringОбязательноТекстовое описание для генерации изображения. Максимум 2000 символов.
sizestringОпциональноРазмер изображения. Поддерживается: 1024*1024, 1024*1536, 1536*1024, 768*1024, 1024*768. По умолчанию: 1024*1024
seednumberОпциональноСлучайное семя для воспроизводимых результатов. -1 для случайного. По умолчанию: -1
output_formatstringОпциональноФормат вывода: jpeg, png или webp. По умолчанию: jpeg
callback_urlstringОпциональноURL-адрес Webhook для уведомления о завершении задачи.

Примеры запросов

Пример текст-в-изображение (cURL)
curl -X POST https://qwen-image-2512.org/api/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A serene mountain landscape at sunset",
    "size": "1024*1024",
    "output_format": "png"
  }'
Успешный ответ
{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n43abc123def456qwenimg",
    "status": "IN_PROGRESS"
  }
}
Ответ с ошибкой
{
  "code": 400,
  "message": "Bad Request: 'prompt' is required.",
  "data": null
}
3

Проверить статус

GEThttps://qwen-image-2512.org/api/status

Опрашивайте эту конечную точку, чтобы проверить прогресс выполнения задачи. Рекомендуем делать запрос каждые 5-10 секунд.

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

ПараметрТипОписание
task_idstringID задачи, полученный от эндпоинта генерации. Обязательно

Значения статуса

PENDINGЗадача в очереди
IN_PROGRESSОбработка
SUCCESSЗавершено
FAILEDПроизошла ошибка
cURL
curl -X GET "https://qwen-image-2512.org/api/status?task_id=n43abc123def456qwenimg" \
  -H "Authorization: Bearer YOUR_API_KEY"
Ответ (В процессе)
{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n43abc123def456qwenimg",
    "status": "IN_PROGRESS",
    "consumed_credits": 5,
    "error_message": null,
    "created_at": "2024-12-19T10:00:00Z",
    "request": { ... },
    "response": null
  }
}
Ответ (Завершено)
{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n43abc123def456qwenimg",
    "status": "SUCCESS",
    "consumed_credits": 5,
    "error_message": null,
    "created_at": "2024-12-19T10:00:00Z",
    "request": { ... },
    "response": ["https://cdn.example.com/image.png"]
  }
}
Ответ (Ошибка)
{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n43abc123def456qwenimg",
    "status": "FAILED",
    "consumed_credits": 0,
    "error_message": "Content policy violation detected",
    "created_at": "2024-12-19T10:00:00Z",
    "request": { ... },
    "response": null
  }
}

Коды ошибок

КодОписание
200Успешно
400Неверный запрос — недопустимые параметры (отсутствует описание, недопустимый размер и т. д.)
401Не авторизован — отсутствует или недействителен API-ключ
404Не найдено — ID задачи не существует
500Внутренняя ошибка сервера — пожалуйста, повторите попытку или обратитесь в службу поддержки

Нужна помощь?

Загляните в наш канал поддержки или напишите нам на электронную почту.

Связаться с поддержкой