Appearance
Seedream 4.5 — Текст В Картинку
POST /images/seedream-t2i
Генерация картинок Seedream 4.5 (ByteDance) из текста. Лимит: 10 запросов/мин.
Базовый URL: https://api.aihere.ru/api/v1
Авторизация: Authorization: Bearer <API-ключ>
Rate-limit: 10 запросов/мин
Параметры
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
prompt | string | да | мин. длина: 1; макс. длина: 3000 |
aspect_ratio | string | — | значения: 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9 |
quality | string | — | значения: basic, high |
Примеры
cURL
bash
curl -X POST "https://api.aihere.ru/api/v1/images/seedream-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": "Кинематографичный кадр: закат над мегаполисом, анаморфотный свет"
}'Python
python
import requests
payload = {
"prompt": "Кинематографичный кадр: закат над мегаполисом, анаморфотный свет"
}
resp = requests.post(
"https://api.aihere.ru/api/v1/images/seedream-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
javascript
const resp = await fetch("https://api.aihere.ru/api/v1/images/seedream-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": "Кинематографичный кадр: закат над мегаполисом, анаморфотный свет"
}),
});
if (!resp.ok) throw new Error(`HTTP ${resp.status}: ${await resp.text()}`);
const { task_id } = await resp.json();
console.log("Задача №" + task_id + " поставлена");PHP
php
$payload = json_decode('{"prompt": "Кинематографичный кадр: закат над мегаполисом, анаморфотный свет"}', true);
$ch = curl_init('https://api.aihere.ru/api/v1/images/seedream-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-ключ |
