Media

POST

media

Создать генерацию медиа

curl --request POST \
  --url https://speshu.ai/api/v1/media \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "seedream-3",
  "input": {
    "prompt": "Космический корабль в стиле киберпанк",
    "aspect_ratio": "16:9",
    "images": [
      {
        "type": "url",
        "data": "https://example.com/image.png"
      }
    ],
    "callBackUrl": "<string>",
    "seed": 42,
    "watermark": "MyBrand",
    "image_resolution": "2K",
    "quality": "high",
    "output_format": "png",
    "max_images": 1,
    "isEnhance": false,
    "guidance_scale": 2.5,
    "strength": 0.8,
    "enable_safety_checker": true,
    "upscale_factor": "2",
    "font_inputs": [
      {
        "font_url": "https://example.com/fonts/custom-font.ttf",
        "text": "Hello World"
      }
    ],
    "super_resolution_references": [
      "https://example.com/reference1.jpg"
    ]
  },
  "provider": {
    "allow_fallbacks": true,
    "order": [
      "OpenAI",
      "Anthropic"
    ],
    "only": [
      "OpenAI",
      "Google"
    ],
    "ignore": [
      "DeepInfra"
    ],
    "sort": "price",
    "max_price": {
      "prompt": 10,
      "completion": 20,
      "image": 5,
      "audio": 15,
      "request": 1
    }
  },
  "async": false,
  "user": "user-123"
}
'

{
  "id": "gen_581761234567890123",
  "object": "media.generation",
  "status": "pending",
  "created": 1703001234,
  "model": "google/gemini-2.5-flash-image",
  "completed_at": 1703001244,
  "data": "<unknown>",
  "usage": {
    "input_units": 1,
    "output_units": 1,
    "duration_seconds": 5,
    "input_tokens": 10,
    "output_tokens": 0,
    "total_tokens": 10,
    "cost_rub": 1.5,
    "cost": 1.5
  },
  "error": {
    "code": "BAD_GATEWAY",
    "message": "Ошибка генерации медиа контента"
  },
  "content": "Банан и яблоко — это фрукты.",
  "reasoning_summary": "Preparing image generation prompt with camera settings...",
  "warnings": [
    "Параметр isEnhance не поддерживается OpenRouter и будет проигнорирован"
  ]
}

О Media API

Универсальный эндпоинт для генерации медиа контента. Поддерживает различные модели и провайдеров через единый интерфейс.

Общие параметры

Параметр	Тип	Обязательный	Описание
`model`	string	Да	ID модели для генерации
`input`	object	Да	Параметры генерации (зависят от модели)
`async`	boolean	Нет	Принудительный асинхронный режим
`user`	string	Нет	Идентификатор конечного пользователя
`provider`	object	Нет	Конфигурация роутинга по провайдерам

Передача файлов (URL и base64)

Для моделей, поддерживающих image-to-image или video-to-video, медиа файлы передаются в массиве images или videos. Каждый элемент — объект с полями:

Поле	Тип	Описание
`type`	`"url"` / `"base64"`	Формат данных
`data`	string	URL файла или base64-строка (с data URI или без)

Пример с base64

curl -X POST "https://speshu.ai/api/v1/media" \
  -H "Authorization: Bearer <SPESHU_AI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-3",
    "input": {
      "prompt": "Сделай изображение ярче и добавь закат на фоне",
      "images": [
        {
          "type": "base64",
          "data": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUg..."
        }
      ]
    }
  }'

Можно комбинировать URL и base64 в одном запросе:

{
  "model": "gpt-image-1",
  "input": {
    "prompt": "Объедини эти изображения в коллаж",
    "images": [
      { "type": "url", "data": "https://example.com/photo1.png" },
      { "type": "base64", "data": "data:image/jpeg;base64,/9j/4AAQSkZJRg..." }
    ]
  }
}

Base64 поддерживается как с data URI (data:image/png;base64,...), так и без — просто строка base64. Если провайдер не поддерживает base64 напрямую, файл автоматически загружается в хранилище и передаётся как URL.

Типы контента

Изображения (Nano Banana, Seedream, GPT Image и др.)
Видео (Veo, Wan, Kling, Seedance, Sora и др.)
Аудио — синтез речи (TTS) и распознавание речи (STT)

Хранение результатов

При генерации медиа контента SpeShu.AI автоматически:

Скачивает результат у AI провайдера на собственное хранилище
Хранит файлы 7 дней для повторного доступа
Раздаёт через CDN для быстрого доступа внутри России

После истечения 7 дней файлы автоматически удаляются. Для постоянного хранения используйте Storage API с политикой PERMANENT.

Руководства по моделям

Подробные примеры, параметры и особенности каждой модели — в руководствах:

Видео

Veo 3.1, Wan 2.5/2.6, Kling, Seedance, Sora и другие модели видеогенерации

Изображения

Seedream, Nano Banana, GPT Image, Flux, Grok Imagine и другие модели генерации изображений

Аудио

ElevenLabs TTS и другие модели синтеза и распознавания речи

Ответ

Возвращает объект Media Status со статусом pending:

{
  "id": "aig_abc123",
  "object": "media.generation",
  "status": "pending",
  "created": 1703001244,
  "model": "google/veo3"
}

Используйте GET /v1/media/ для проверки статуса и получения результата.

Авторизации

Authorization

string

header

обязательно

API ключ передаётся в заголовке: Authorization: Bearer <SPESHU_AI_API_KEY>

Тело

application/json

model

string

обязательно

ID модели для генерации

Пример:

"seedream-3"

input

Изображение · object

обязательно

Входные параметры генерации

Изображение
Видео
Аудио (TTS)
Музыка

Show child attributes

provider

object

Настройки роутинга провайдеров

Show child attributes

async

boolean

по умолчанию:false

Асинхронный режим генерации. При true возвращается taskId для опроса статуса

Пример:

false

user

string

Уникальный идентификатор конечного пользователя для отслеживания и предотвращения злоупотреблений

Пример:

"user-123"

Ответ

string

обязательно

Уникальный идентификатор генерации

Пример:

"gen_581761234567890123"

object

string

обязательно

Тип объекта

Пример:

"media.generation"

status

enum<string>

обязательно

Статус генерации

Доступные опции:

pending,

processing,

completed,

failed,

cancelled

Пример:

"pending"

created

number

обязательно

Временная метка создания (Unix timestamp)

Пример:

1703001234

model

string

обязательно

ID модели, которая генерирует контент

Пример:

"google/gemini-2.5-flash-image"

completed_at

number

Временная метка завершения (Unix timestamp)

Пример:

1703001244

data

Данные сгенерированного контента

usage

object

Информация об использовании ресурсов

Show child attributes

error

object

Информация об ошибке (если failed)

Show child attributes

content

string

Текстовый ответ модели (если вернула текст вместо/вместе с изображением)

Пример:

"Банан и яблоко — это фрукты."

reasoning_summary

string

Краткое резюме рассуждений модели

Пример:

"Preparing image generation prompt with camera settings..."

warnings

string[]

Предупреждения (неподдерживаемые параметры и т.д.)

Пример:

[
  "Параметр isEnhance не поддерживается OpenRouter и будет проигнорирован"
]

Создать генерацию медиа

curl --request POST \
  --url https://speshu.ai/api/v1/media \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "seedream-3",
  "input": {
    "prompt": "Космический корабль в стиле киберпанк",
    "aspect_ratio": "16:9",
    "images": [
      {
        "type": "url",
        "data": "https://example.com/image.png"
      }
    ],
    "callBackUrl": "<string>",
    "seed": 42,
    "watermark": "MyBrand",
    "image_resolution": "2K",
    "quality": "high",
    "output_format": "png",
    "max_images": 1,
    "isEnhance": false,
    "guidance_scale": 2.5,
    "strength": 0.8,
    "enable_safety_checker": true,
    "upscale_factor": "2",
    "font_inputs": [
      {
        "font_url": "https://example.com/fonts/custom-font.ttf",
        "text": "Hello World"
      }
    ],
    "super_resolution_references": [
      "https://example.com/reference1.jpg"
    ]
  },
  "provider": {
    "allow_fallbacks": true,
    "order": [
      "OpenAI",
      "Anthropic"
    ],
    "only": [
      "OpenAI",
      "Google"
    ],
    "ignore": [
      "DeepInfra"
    ],
    "sort": "price",
    "max_price": {
      "prompt": 10,
      "completion": 20,
      "image": 5,
      "audio": 15,
      "request": 1
    }
  },
  "async": false,
  "user": "user-123"
}
'

{
  "id": "gen_581761234567890123",
  "object": "media.generation",
  "status": "pending",
  "created": 1703001234,
  "model": "google/gemini-2.5-flash-image",
  "completed_at": 1703001244,
  "data": "<unknown>",
  "usage": {
    "input_units": 1,
    "output_units": 1,
    "duration_seconds": 5,
    "input_tokens": 10,
    "output_tokens": 0,
    "total_tokens": 10,
    "cost_rub": 1.5,
    "cost": 1.5
  },
  "error": {
    "code": "BAD_GATEWAY",
    "message": "Ошибка генерации медиа контента"
  },
  "content": "Банан и яблоко — это фрукты.",
  "reasoning_summary": "Preparing image generation prompt with camera settings...",
  "warnings": [
    "Параметр isEnhance не поддерживается OpenRouter и будет проигнорирован"
  ]
}

Текстовая генерация

Модели

Другое

О Media API

Общие параметры

Передача файлов (URL и base64)

Пример с base64

Типы контента

Хранение результатов

Руководства по моделям

Видео

Изображения

Аудио

Ответ

Авторизации

Тело

Ответ

Текстовая генерация

Модели

Другое

Documentation Index

​О Media API

​Общие параметры

​Передача файлов (URL и base64)

​Пример с base64

​Типы контента

​Хранение результатов

​Руководства по моделям

​Видео

​Изображения

​Аудио

​Ответ

Авторизации

Тело

Ответ

О Media API

Общие параметры

Передача файлов (URL и base64)

Пример с base64

Типы контента

Хранение результатов

Руководства по моделям

Видео

Изображения

Аудио

Ответ