Справочник API

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

Краткий справочник по аутентификации, генерации изображений, статусам задач, ID моделей и ошибкам.

Создать API-ключ Модели

Быстрый старт

API использует стандартный JSON по HTTPS. Создайте ключ, отправьте генерацию и опрашивайте ID задачи.

01
Создайте Bearer-ключ
02
Отправьте генерацию
03
Опрашивайте ID задачи

Базовый URL

Все публичные API-запросы используют домен qwenapi.org.

https://qwenapi.org

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

Передавайте Qwen API-ключ в заголовке Authorization для генерации, статуса и истории.

Authorization: Bearer $QWEN_API_KEY

Храните API-ключи на сервере. Не публикуйте их в браузерных сборках, репозиториях и клиентских логах.

Создать изображение

Отправьте ID активной модели и поля ввода, описанные для нее.

POST/api/v1/images/generations

curl https://qwenapi.org/api/v1/images/generations \
  -H "Authorization: Bearer $QWEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-image-3",
    "prompt": "Editorial product photo in soft morning light",
    "aspect_ratio": "16:9",
    "resolution": "1K"
  }'

Ответ о принятии

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n86...qw3",
    "status": "IN_PROGRESS"
  }
}

Статус задачи

Используйте ID задачи, чтобы получить прогресс, ошибки и финальные URL.

GET/api/v1/tasks/:task_id

curl "https://qwenapi.org/api/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $QWEN_API_KEY"

IN_PROGRESS

Backend принял задачу и выполняет ее.

SUCCESS

URL результата готовы.

FAILED

Задача завершилась структурированной ошибкой.

ID активных моделей

Только эти ID сейчас направляются в production-маршруты с биллингом.

Модель	Стоимость	Вход	Выход
qwen-image-3	10 credits / image	Text, up to 3 images	PNG or JPEG
qwen2-image	10 credits / image	Text or image	PNG or JPEG
qwen-image-2512	5 credits / image	Text or images	PNG, JPEG, WebP
qwen-multi-angles	5 credits / image	1-3 images	PNG or JPEG
qwen-layered	10 credits / layer	Image and instruction	Layer images

Ошибки

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

400invalid_requestПроверьте ID модели и поля запроса.

401unauthorizedУбедитесь, что Bearer-ключ указан и активен.

402insufficient_creditsПополните кредиты в панели биллинга.

404not_foundПроверьте, что ID задачи относится к маршруту Qwen.

429rate_limitedПовторите запрос с задержкой и jitter.

500server_errorПовторите позже и сохраните ID задачи для поддержки.