> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Генерация изображений Qwen Image 2.0
> - Асинхронный режим обработки, возвращает идентификатор задачи для последующих запросов
- Поддерживает text-to-image, image-to-image и другие режимы генерации
- Поддерживает уровни разрешения 1K/2K, генерирует до 6 изображений
```bash cURL theme={null}
curl --request POST \
--url https://api.apimart.ai/v1/images/generations \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data '{
"model": "qwen-image-2.0",
"prompt": "A cute orange cat napping in the sunshine"
}'
```
```python Python theme={null}
import requests
url = "https://api.apimart.ai/v1/images/generations"
payload = {
"model": "qwen-image-2.0",
"prompt": "A cute orange cat napping in the sunshine"
}
headers = {
"Authorization": "Bearer ",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
```
```javascript JavaScript theme={null}
const url = "https://api.apimart.ai/v1/images/generations";
const payload = {
model: "qwen-image-2.0",
prompt: "A cute orange cat napping in the sunshine",
};
const headers = {
Authorization: "Bearer ",
"Content-Type": "application/json",
};
fetch(url, {
method: "POST",
headers: headers,
body: JSON.stringify(payload),
})
.then((response) => response.json())
.then((data) => console.log(data))
.catch((error) => console.error("Error:", error));
```
```json 200 theme={null}
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_01JGXYZ1234567890ABCDEF"
}
]
}
```
```json 400 theme={null}
{
"error": {
"code": 400,
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}
```
```json 401 theme={null}
{
"error": {
"code": 401,
"message": "Authentication failed, please check your API key",
"type": "authentication_error"
}
}
```
```json 402 theme={null}
{
"error": {
"code": 402,
"message": "Insufficient balance, please top up",
"type": "payment_required"
}
}
```
## Поддерживаемые модели
| Модель | Описание | Максимум изображений | Цена |
| -------------------- | ------------------------------------------------------------------------------ | -------------------- | ------------------ |
| `qwen-image-2.0` | Стандартная версия, сбалансированное качество и производительность | 6 | Фиксированная цена |
| `qwen-image-2.0-pro` | Pro-версия, более сильный рендеринг текста, более тонкие реалистичные текстуры | 6 | Фиксированная цена |
## Авторизация
Все конечные точки требуют аутентификации Bearer Token
Получите API Key:
Перейдите на [страницу управления API ключами](https://apimart.ai/keys), чтобы получить свой API Key
Добавьте в заголовок запроса:
```
Authorization: Bearer YOUR_API_KEY
```
## Тело запроса
Название модели
* `qwen-image-2.0` — стандартная версия, сбалансированное качество и производительность
* `qwen-image-2.0-pro` — Pro-версия, более сильный рендеринг текста, более тонкие реалистичные текстуры
Текстовое описание для генерации изображения, до 800 символов
Соотношение сторон изображения
Поддерживаемые соотношения сторон:
* `1:1` — квадрат (по умолчанию)
* `4:3` — горизонтальный 4:3
* `3:4` — вертикальный 3:4
* `16:9` — горизонтальный широкоформатный
* `9:16` — вертикальный
* `3:2` — горизонтальный 3:2
* `2:3` — вертикальный 2:3
Уровень разрешения
* `1K` — стандартное разрешение (по умолчанию)
* `2K` — высокое разрешение
Количество генерируемых изображений
Диапазон: 1–6
Негативный промпт (содержимое, которое вы не хотите видеть), до 500 символов
Массив URL референсных изображений (режим image-to-image)
**Ограничения:**
* Должны быть публично доступные URL
* Формат Base64 не поддерживается
## Справочная таблица разрешений
Размер вывода определяется комбинацией `size` (соотношение) + `resolution` (уровень разрешения).
| Соотношение | Уровень 1K | Уровень 2K |
| ----------- | ---------- | ---------- |
| `1:1` | 1024×1024 | 2048×2048 |
| `4:3` | 1152×864 | 2048×1536 |
| `3:4` | 864×1152 | 1536×2048 |
| `16:9` | 1280×720 | 2048×1152 |
| `9:16` | 720×1280 | 1152×2048 |
| `3:2` | 1248×832 | 2048×1360 |
| `2:3` | 832×1248 | 1360×2048 |
* Только `size` → по умолчанию уровень 1K: `{"size": "16:9"}` → 1280×720
* `size` + `resolution` → указанный уровень: `{"size": "16:9", "resolution": "2K"}` → 2048×1152
## Примеры использования
**Text-to-image (минимальный запрос)**
```json theme={null}
{
"model": "qwen-image-2.0",
"prompt": "A cute orange cat napping in the sunshine"
}
```
**Указание соотношения и количества**
```json theme={null}
{
"model": "qwen-image-2.0-pro",
"prompt": "Cyberpunk-style futuristic city nightscape with flickering neon lights",
"size": "16:9",
"n": 4
}
```
**Высокое разрешение уровня 2K**
```json theme={null}
{
"model": "qwen-image-2.0-pro",
"prompt": "Exquisite food photography, sushi platter",
"size": "4:3",
"resolution": "2K",
"n": 2
}
```
**Image-to-image (референсное изображение + текстовое описание)**
```json theme={null}
{
"model": "qwen-image-2.0",
"prompt": "Change the background to a seaside sunset",
"image_urls": ["https://example.com/my-photo.jpg"]
}
```
## Ответ
Код состояния ответа
Массив данных ответа
Статус задачи
* `submitted` — отправлено
Уникальный идентификатор задачи
## Примечания
1. **Асинхронная обработка**: после отправки возвращается `task_id`. Опрашивайте `/v1/tasks/{task_id}` для получения результатов
2. **Хранение изображений**: сгенерированные изображения зеркалируются на CDN платформы и действительны длительное время
3. **Правила тарификации**: тарификация за каждое успешно сгенерированное изображение, неудачные не оплачиваются
4. **Требования к URL изображений**: входные изображения должны быть публично доступными URL, base64 не поддерживается