Appearance
Qwen Image 3 — Текст в Картинку
POST /images/qwen-image-t2i
Генерация картинок Qwen Image 3 (Alibaba) из текста; хорошо рисует текст на картинке, понимает китайский. Лимит: 10 запросов/мин.
Базовый URL: https://api.aihere.ru/api/v1
Авторизация: Authorization: Bearer <API-ключ>
Rate-limit: 10 запросов/мин
Параметры
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
prompt | string | да | мин. длина: 1; макс. длина: 20000 |
resolution | string | — | значения: 1K, 2K; по умолчанию 1K |
image_size | string | — | значения: 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9; по умолчанию 16:9 |
output_format | string | — | значения: png, jpeg; по умолчанию png |
prompt_extend | boolean | — | по умолчанию true |
negative_prompt | string (опционально) | — | макс. длина: 2000 |
seed | integer (опционально) | — | мин: 0.0; макс: 2147483647.0 |
Примеры
bash
curl -X POST "https://api.aihere.ru/api/v1/images/qwen-image-t2i" \
-H "Authorization: Bearer $AIHERE_API_KEY" \
-H "Content-Type: application/json" \
-H "X-Callback-Url: https://myapp.example.com/api/aihere-callback" \
-d '{
"prompt": "Кинематографичный кадр: закат над мегаполисом, анаморфотный свет",
"resolution": "1K",
"image_size": "16:9",
"output_format": "png",
"prompt_extend": true
}'python
import requests
payload = {
"prompt": "Кинематографичный кадр: закат над мегаполисом, анаморфотный свет",
"resolution": "1K",
"image_size": "16:9",
"output_format": "png",
"prompt_extend": True
}
resp = requests.post(
"https://api.aihere.ru/api/v1/images/qwen-image-t2i",
headers={
"Authorization": f"Bearer {API_KEY}",
# Опционально: вебхук о завершении задачи
# "X-Callback-Url": "https://myapp.example.com/api/aihere-callback",
},
json=payload,
timeout=60,
)
resp.raise_for_status()
task_id = resp.json()["task_id"]
print(f"Задача №{task_id} поставлена")javascript
const resp = await fetch("https://api.aihere.ru/api/v1/images/qwen-image-t2i", {
method: "POST",
headers: {
Authorization: `Bearer ${API_KEY}`,
"Content-Type": "application/json",
// Опционально: "X-Callback-Url": "https://myapp.example.com/api/aihere-callback",
},
body: JSON.stringify({
"prompt": "Кинематографичный кадр: закат над мегаполисом, анаморфотный свет",
"resolution": "1K",
"image_size": "16:9",
"output_format": "png",
"prompt_extend": true
}),
});
if (!resp.ok) throw new Error(`HTTP ${resp.status}: ${await resp.text()}`);
const { task_id } = await resp.json();
console.log("Задача №" + task_id + " поставлена");php
$payload = json_decode('{"prompt": "Кинематографичный кадр: закат над мегаполисом, анаморфотный свет", "resolution": "1K", "image_size": "16:9", "output_format": "png", "prompt_extend": true}', true);
$ch = curl_init('https://api.aihere.ru/api/v1/images/qwen-image-t2i');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => json_encode($payload),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer $apiKey",
'Content-Type: application/json',
// Опционально: 'X-Callback-Url: https://myapp.example.com/api/aihere-callback',
],
]);
$resp = json_decode(curl_exec($ch), true);
curl_close($ch);
echo "Задача №{$resp['task_id']} поставлена";Ответ 200
ID генерации
json
{
"task_id": 123
}Ошибки
| Код | Причина |
|---|---|
| 429 | Превышен rate-limit |
| 502 | Ошибка провайдера генерации |
| 503 | Провайдер недоступен или сбой сервиса баланса (списанные средства возвращаются) |
| 422 | Ошибка валидации тела запроса (detail содержит список полей) |
| 401 | Нет или невалидный API-ключ |
