GET Media Status

Получить статус генерации

curl --request GET \
  --url https://polza.ai/api/v1/media/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://polza.ai/api/v1/media/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://polza.ai/api/v1/media/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://polza.ai/api/v1/media/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://polza.ai/api/v1/media/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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 и будет проигнорирован"
  ]
}

GET

media

{id}

Получить статус генерации

curl --request GET \
  --url https://polza.ai/api/v1/media/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://polza.ai/api/v1/media/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://polza.ai/api/v1/media/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://polza.ai/api/v1/media/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://polza.ai/api/v1/media/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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 и будет проигнорирован"
  ]
}

Polling

Рекомендуется проверять статус с интервалом 3-5 секунд для изображений и 5-10 секунд для видео.

Статусы

Статус	Описание
`pending`	В очереди
`processing`	Генерация выполняется
`completed`	Готово — результат в поле `data`
`failed`	Ошибка — подробности в поле `error`

Ответ (completed)

{
  "id": "aig_abc123",
  "object": "media.generation",
  "status": "completed",
  "created": 1703001244,
  "model": "google/gemini-2.5-flash-image",
  "data": {
    "url": "https://s3.polza.ai/f/205141/2026/03/aig_abc123.jpg"
  },
  "usage": {
    "output_units": 1,
    "cost_rub": 5.00,
    "cost": 5.00
  }
}

Примеры polling

import requests
import time

def wait_for_media(api_key, media_id, interval=5, max_wait=300):
    url = f'https://polza.ai/api/v1/media/{media_id}'
    headers = {'Authorization': f'Bearer {api_key}'}
    elapsed = 0

    while elapsed < max_wait:
        response = requests.get(url, headers=headers)
        data = response.json()

        if data['status'] == 'completed':
            return data
        elif data['status'] == 'failed':
            raise Exception(f"Генерация не удалась: {data.get('error')}")

        time.sleep(interval)
        elapsed += interval

    raise TimeoutError("Превышено время ожидания")

result = wait_for_media('YOUR_API_KEY', 'aig_abc123')
print(f"Результат: {result['data']['url']}")

async function waitForMedia(apiKey, mediaId, interval = 5000, maxWait = 300000) {
  const url = `https://polza.ai/api/v1/media/${mediaId}`;
  let elapsed = 0;

  while (elapsed < maxWait) {
    const response = await fetch(url, {
      headers: { 'Authorization': `Bearer ${apiKey}` }
    });
    const data = await response.json();

    if (data.status === 'completed') return data;
    if (data.status === 'failed') throw new Error(`Ошибка: ${data.error}`);

    await new Promise(resolve => setTimeout(resolve, interval));
    elapsed += interval;
  }

  throw new Error('Превышено время ожидания');
}

Результаты хранятся 7 дней на CDN. Для постоянного хранения используйте Storage API.

Авторизации

Authorization

string

header

обязательно

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

Параметры пути

string

обязательно

Ответ

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 и будет проигнорирован"
]

Обзор

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

Изображения

Медиа

Аудио

Эмбеддинги

Модели

Хранилище

История

Другое

Polling

Статусы

Ответ (completed)

Примеры polling

Авторизации

Параметры пути

Ответ

​Polling

​Статусы

​Ответ (completed)

​Примеры polling

Авторизации

Параметры пути

Ответ

Polling

Статусы

Ответ (completed)

Примеры polling