Nano Banana 2

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

curl --request POST \
  --url https://polza.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",
    "animation": true,
    "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": {
    "require_parameters": true,
    "allow_fallbacks": true,
    "order": [
      "OpenAI",
      "Anthropic"
    ],
    "only": [
      "OpenAI",
      "Google"
    ],
    "ignore": [
      "DeepInfra"
    ],
    "sort": "price",
    "data_residency": "ru",
    "max_price": {
      "prompt": 10,
      "completion": 20,
      "image": 5,
      "audio": 15,
      "request": 1,
      "video_per_second": 50,
      "stt_per_minute": 5,
      "tts_per_million_characters": 1500
    }
  },
  "async": false,
  "user": "user-123"
}
'

import requests

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

payload = {
    "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",
        "animation": True,
        "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": {
        "require_parameters": True,
        "allow_fallbacks": True,
        "order": ["OpenAI", "Anthropic"],
        "only": ["OpenAI", "Google"],
        "ignore": ["DeepInfra"],
        "sort": "price",
        "data_residency": "ru",
        "max_price": {
            "prompt": 10,
            "completion": 20,
            "image": 5,
            "audio": 15,
            "request": 1,
            "video_per_second": 50,
            "stt_per_minute": 5,
            "tts_per_million_characters": 1500
        }
    },
    "async": False,
    "user": "user-123"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    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',
      animation: true,
      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: {
      require_parameters: true,
      allow_fallbacks: true,
      order: ['OpenAI', 'Anthropic'],
      only: ['OpenAI', 'Google'],
      ignore: ['DeepInfra'],
      sort: 'price',
      data_residency: 'ru',
      max_price: {
        prompt: 10,
        completion: 20,
        image: 5,
        audio: 15,
        request: 1,
        video_per_second: 50,
        stt_per_minute: 5,
        tts_per_million_characters: 1500
      }
    },
    async: false,
    user: 'user-123'
  })
};

fetch('https://polza.ai/api/v1/media', 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",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    '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',
        'animation' => true,
        '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' => [
        'require_parameters' => true,
        'allow_fallbacks' => true,
        'order' => [
                'OpenAI',
                'Anthropic'
        ],
        'only' => [
                'OpenAI',
                'Google'
        ],
        'ignore' => [
                'DeepInfra'
        ],
        'sort' => 'price',
        'data_residency' => 'ru',
        'max_price' => [
                'prompt' => 10,
                'completion' => 20,
                'image' => 5,
                'audio' => 15,
                'request' => 1,
                'video_per_second' => 50,
                'stt_per_minute' => 5,
                'tts_per_million_characters' => 1500
        ]
    ],
    'async' => false,
    'user' => 'user-123'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

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

	payload := strings.NewReader("{\n  \"model\": \"seedream-3\",\n  \"input\": {\n    \"prompt\": \"Космический корабль в стиле киберпанк\",\n    \"aspect_ratio\": \"16:9\",\n    \"images\": [\n      {\n        \"type\": \"url\",\n        \"data\": \"https://example.com/image.png\"\n      }\n    ],\n    \"callBackUrl\": \"<string>\",\n    \"seed\": 42,\n    \"watermark\": \"MyBrand\",\n    \"image_resolution\": \"2K\",\n    \"quality\": \"high\",\n    \"output_format\": \"png\",\n    \"animation\": true,\n    \"max_images\": 1,\n    \"isEnhance\": false,\n    \"guidance_scale\": 2.5,\n    \"strength\": 0.8,\n    \"enable_safety_checker\": true,\n    \"upscale_factor\": \"2\",\n    \"font_inputs\": [\n      {\n        \"font_url\": \"https://example.com/fonts/custom-font.ttf\",\n        \"text\": \"Hello World\"\n      }\n    ],\n    \"super_resolution_references\": [\n      \"https://example.com/reference1.jpg\"\n    ]\n  },\n  \"provider\": {\n    \"require_parameters\": true,\n    \"allow_fallbacks\": true,\n    \"order\": [\n      \"OpenAI\",\n      \"Anthropic\"\n    ],\n    \"only\": [\n      \"OpenAI\",\n      \"Google\"\n    ],\n    \"ignore\": [\n      \"DeepInfra\"\n    ],\n    \"sort\": \"price\",\n    \"data_residency\": \"ru\",\n    \"max_price\": {\n      \"prompt\": 10,\n      \"completion\": 20,\n      \"image\": 5,\n      \"audio\": 15,\n      \"request\": 1,\n      \"video_per_second\": 50,\n      \"stt_per_minute\": 5,\n      \"tts_per_million_characters\": 1500\n    }\n  },\n  \"async\": false,\n  \"user\": \"user-123\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

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

require 'uri'
require 'net/http'

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

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

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

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": {
    "url": "https://example.com/image.png",
    "b64_json": "iVBORw0KGgoAAAANSUhEUgAAAAUA...",
    "revised_prompt": "A beautiful sunset over the ocean"
  },
  "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": "Ошибка генерации медиа контента",
    "metadata": {
      "raw": "content policy violation",
      "provider_name": "alibaba"
    }
  },
  "content": "Банан и яблоко — это фрукты.",
  "reasoning_summary": "Preparing image generation prompt with camera settings...",
  "warnings": [
    "Параметр isEnhance не поддерживается и будет проигнорирован"
  ]
}

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Недопустимое значение параметра",
    "trace_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {},
    "metadata": {
      "reason": "noProvidersForModel",
      "raw": "The parameter `duration` specified in the request is not valid",
      "provider_name": "alibaba"
    }
  },
  "trace_id": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Недопустимое значение параметра",
    "trace_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {},
    "metadata": {
      "reason": "noProvidersForModel",
      "raw": "The parameter `duration` specified in the request is not valid",
      "provider_name": "alibaba"
    }
  },
  "trace_id": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Недопустимое значение параметра",
    "trace_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {},
    "metadata": {
      "reason": "noProvidersForModel",
      "raw": "The parameter `duration` specified in the request is not valid",
      "provider_name": "alibaba"
    }
  },
  "trace_id": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Недопустимое значение параметра",
    "trace_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {},
    "metadata": {
      "reason": "noProvidersForModel",
      "raw": "The parameter `duration` specified in the request is not valid",
      "provider_name": "alibaba"
    }
  },
  "trace_id": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Недопустимое значение параметра",
    "trace_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {},
    "metadata": {
      "reason": "noProvidersForModel",
      "raw": "The parameter `duration` specified in the request is not valid",
      "provider_name": "alibaba"
    }
  },
  "trace_id": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Недопустимое значение параметра",
    "trace_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {},
    "metadata": {
      "reason": "noProvidersForModel",
      "raw": "The parameter `duration` specified in the request is not valid",
      "provider_name": "alibaba"
    }
  },
  "trace_id": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Недопустимое значение параметра",
    "trace_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {},
    "metadata": {
      "reason": "noProvidersForModel",
      "raw": "The parameter `duration` specified in the request is not valid",
      "provider_name": "alibaba"
    }
  },
  "trace_id": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Недопустимое значение параметра",
    "trace_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {},
    "metadata": {
      "reason": "noProvidersForModel",
      "raw": "The parameter `duration` specified in the request is not valid",
      "provider_name": "alibaba"
    }
  },
  "trace_id": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Недопустимое значение параметра",
    "trace_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {},
    "metadata": {
      "reason": "noProvidersForModel",
      "raw": "The parameter `duration` specified in the request is not valid",
      "provider_name": "alibaba"
    }
  },
  "trace_id": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Недопустимое значение параметра",
    "trace_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {},
    "metadata": {
      "reason": "noProvidersForModel",
      "raw": "The parameter `duration` specified in the request is not valid",
      "provider_name": "alibaba"
    }
  },
  "trace_id": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Недопустимое значение параметра",
    "trace_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {},
    "metadata": {
      "reason": "noProvidersForModel",
      "raw": "The parameter `duration` specified in the request is not valid",
      "provider_name": "alibaba"
    }
  },
  "trace_id": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Недопустимое значение параметра",
    "trace_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {},
    "metadata": {
      "reason": "noProvidersForModel",
      "raw": "The parameter `duration` specified in the request is not valid",
      "provider_name": "alibaba"
    }
  },
  "trace_id": "550e8400-e29b-41d4-a716-446655440000"
}

POST

media

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

curl --request POST \
  --url https://polza.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",
    "animation": true,
    "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": {
    "require_parameters": true,
    "allow_fallbacks": true,
    "order": [
      "OpenAI",
      "Anthropic"
    ],
    "only": [
      "OpenAI",
      "Google"
    ],
    "ignore": [
      "DeepInfra"
    ],
    "sort": "price",
    "data_residency": "ru",
    "max_price": {
      "prompt": 10,
      "completion": 20,
      "image": 5,
      "audio": 15,
      "request": 1,
      "video_per_second": 50,
      "stt_per_minute": 5,
      "tts_per_million_characters": 1500
    }
  },
  "async": false,
  "user": "user-123"
}
'

import requests

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

payload = {
    "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",
        "animation": True,
        "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": {
        "require_parameters": True,
        "allow_fallbacks": True,
        "order": ["OpenAI", "Anthropic"],
        "only": ["OpenAI", "Google"],
        "ignore": ["DeepInfra"],
        "sort": "price",
        "data_residency": "ru",
        "max_price": {
            "prompt": 10,
            "completion": 20,
            "image": 5,
            "audio": 15,
            "request": 1,
            "video_per_second": 50,
            "stt_per_minute": 5,
            "tts_per_million_characters": 1500
        }
    },
    "async": False,
    "user": "user-123"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    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',
      animation: true,
      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: {
      require_parameters: true,
      allow_fallbacks: true,
      order: ['OpenAI', 'Anthropic'],
      only: ['OpenAI', 'Google'],
      ignore: ['DeepInfra'],
      sort: 'price',
      data_residency: 'ru',
      max_price: {
        prompt: 10,
        completion: 20,
        image: 5,
        audio: 15,
        request: 1,
        video_per_second: 50,
        stt_per_minute: 5,
        tts_per_million_characters: 1500
      }
    },
    async: false,
    user: 'user-123'
  })
};

fetch('https://polza.ai/api/v1/media', 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",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    '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',
        'animation' => true,
        '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' => [
        'require_parameters' => true,
        'allow_fallbacks' => true,
        'order' => [
                'OpenAI',
                'Anthropic'
        ],
        'only' => [
                'OpenAI',
                'Google'
        ],
        'ignore' => [
                'DeepInfra'
        ],
        'sort' => 'price',
        'data_residency' => 'ru',
        'max_price' => [
                'prompt' => 10,
                'completion' => 20,
                'image' => 5,
                'audio' => 15,
                'request' => 1,
                'video_per_second' => 50,
                'stt_per_minute' => 5,
                'tts_per_million_characters' => 1500
        ]
    ],
    'async' => false,
    'user' => 'user-123'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

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

	payload := strings.NewReader("{\n  \"model\": \"seedream-3\",\n  \"input\": {\n    \"prompt\": \"Космический корабль в стиле киберпанк\",\n    \"aspect_ratio\": \"16:9\",\n    \"images\": [\n      {\n        \"type\": \"url\",\n        \"data\": \"https://example.com/image.png\"\n      }\n    ],\n    \"callBackUrl\": \"<string>\",\n    \"seed\": 42,\n    \"watermark\": \"MyBrand\",\n    \"image_resolution\": \"2K\",\n    \"quality\": \"high\",\n    \"output_format\": \"png\",\n    \"animation\": true,\n    \"max_images\": 1,\n    \"isEnhance\": false,\n    \"guidance_scale\": 2.5,\n    \"strength\": 0.8,\n    \"enable_safety_checker\": true,\n    \"upscale_factor\": \"2\",\n    \"font_inputs\": [\n      {\n        \"font_url\": \"https://example.com/fonts/custom-font.ttf\",\n        \"text\": \"Hello World\"\n      }\n    ],\n    \"super_resolution_references\": [\n      \"https://example.com/reference1.jpg\"\n    ]\n  },\n  \"provider\": {\n    \"require_parameters\": true,\n    \"allow_fallbacks\": true,\n    \"order\": [\n      \"OpenAI\",\n      \"Anthropic\"\n    ],\n    \"only\": [\n      \"OpenAI\",\n      \"Google\"\n    ],\n    \"ignore\": [\n      \"DeepInfra\"\n    ],\n    \"sort\": \"price\",\n    \"data_residency\": \"ru\",\n    \"max_price\": {\n      \"prompt\": 10,\n      \"completion\": 20,\n      \"image\": 5,\n      \"audio\": 15,\n      \"request\": 1,\n      \"video_per_second\": 50,\n      \"stt_per_minute\": 5,\n      \"tts_per_million_characters\": 1500\n    }\n  },\n  \"async\": false,\n  \"user\": \"user-123\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

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

require 'uri'
require 'net/http'

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

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

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

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": {
    "url": "https://example.com/image.png",
    "b64_json": "iVBORw0KGgoAAAANSUhEUgAAAAUA...",
    "revised_prompt": "A beautiful sunset over the ocean"
  },
  "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": "Ошибка генерации медиа контента",
    "metadata": {
      "raw": "content policy violation",
      "provider_name": "alibaba"
    }
  },
  "content": "Банан и яблоко — это фрукты.",
  "reasoning_summary": "Preparing image generation prompt with camera settings...",
  "warnings": [
    "Параметр isEnhance не поддерживается и будет проигнорирован"
  ]
}

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Недопустимое значение параметра",
    "trace_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {},
    "metadata": {
      "reason": "noProvidersForModel",
      "raw": "The parameter `duration` specified in the request is not valid",
      "provider_name": "alibaba"
    }
  },
  "trace_id": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Недопустимое значение параметра",
    "trace_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {},
    "metadata": {
      "reason": "noProvidersForModel",
      "raw": "The parameter `duration` specified in the request is not valid",
      "provider_name": "alibaba"
    }
  },
  "trace_id": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Недопустимое значение параметра",
    "trace_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {},
    "metadata": {
      "reason": "noProvidersForModel",
      "raw": "The parameter `duration` specified in the request is not valid",
      "provider_name": "alibaba"
    }
  },
  "trace_id": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Недопустимое значение параметра",
    "trace_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {},
    "metadata": {
      "reason": "noProvidersForModel",
      "raw": "The parameter `duration` specified in the request is not valid",
      "provider_name": "alibaba"
    }
  },
  "trace_id": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Недопустимое значение параметра",
    "trace_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {},
    "metadata": {
      "reason": "noProvidersForModel",
      "raw": "The parameter `duration` specified in the request is not valid",
      "provider_name": "alibaba"
    }
  },
  "trace_id": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Недопустимое значение параметра",
    "trace_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {},
    "metadata": {
      "reason": "noProvidersForModel",
      "raw": "The parameter `duration` specified in the request is not valid",
      "provider_name": "alibaba"
    }
  },
  "trace_id": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Недопустимое значение параметра",
    "trace_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {},
    "metadata": {
      "reason": "noProvidersForModel",
      "raw": "The parameter `duration` specified in the request is not valid",
      "provider_name": "alibaba"
    }
  },
  "trace_id": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Недопустимое значение параметра",
    "trace_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {},
    "metadata": {
      "reason": "noProvidersForModel",
      "raw": "The parameter `duration` specified in the request is not valid",
      "provider_name": "alibaba"
    }
  },
  "trace_id": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Недопустимое значение параметра",
    "trace_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {},
    "metadata": {
      "reason": "noProvidersForModel",
      "raw": "The parameter `duration` specified in the request is not valid",
      "provider_name": "alibaba"
    }
  },
  "trace_id": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Недопустимое значение параметра",
    "trace_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {},
    "metadata": {
      "reason": "noProvidersForModel",
      "raw": "The parameter `duration` specified in the request is not valid",
      "provider_name": "alibaba"
    }
  },
  "trace_id": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Недопустимое значение параметра",
    "trace_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {},
    "metadata": {
      "reason": "noProvidersForModel",
      "raw": "The parameter `duration` specified in the request is not valid",
      "provider_name": "alibaba"
    }
  },
  "trace_id": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Недопустимое значение параметра",
    "trace_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {},
    "metadata": {
      "reason": "noProvidersForModel",
      "raw": "The parameter `duration` specified in the request is not valid",
      "provider_name": "alibaba"
    }
  },
  "trace_id": "550e8400-e29b-41d4-a716-446655440000"
}

Nano Banana 2 (google/gemini-3.1-flash-image-preview) — модель генерации и редактирования изображений с поддержкой до 4K разрешения, точным рендерингом текста и возможностью передавать до 8 референс-изображений.

Характеристики

Характеристика	Nano Banana	Nano Banana 2
ID модели	`google/gemini-2.5-flash-image`	`google/gemini-3.1-flash-image-preview`
Max prompt	20 000 символов	20 000 символов
Разрешения	—	1K, 2K, 4K
Aspect ratio	10 вариантов	11 вариантов
Референс-изображения	до 8	до 8

Примеры

Редактирование с референс-изображением

const response = await fetch('https://polza.ai/api/v1/media', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <POLZA_AI_API_KEY>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'google/gemini-3.1-flash-image-preview',
    input: {
      prompt: "Добавь текст 'SALE 50%' крупными буквами в центре",
      image_resolution: '4K',
      images: [
        { type: 'url', data: 'https://example.com/banner.jpg' }
      ]
    }
  })
});

import requests

response = requests.post(
    'https://polza.ai/api/v1/media',
    headers={'Authorization': 'Bearer <POLZA_AI_API_KEY>'},
    json={
        'model': 'google/gemini-3.1-flash-image-preview',
        'input': {
            'prompt': "Добавь текст 'SALE 50%' крупными буквами в центре",
            'image_resolution': '4K',
            'images': [
                {'type': 'url', 'data': 'https://example.com/banner.jpg'}
            ]
        }
    }
)

curl -X POST "https://polza.ai/api/v1/media" \
  -H "Authorization: Bearer <POLZA_AI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-3.1-flash-image-preview",
    "input": {
      "prompt": "Добавь текст SALE 50% крупными буквами в центре",
      "image_resolution": "4K",
      "images": [
        { "type": "url", "data": "https://example.com/banner.jpg" }
      ]
    }
  }'

Ответ

API возвращает объект с ID задачи:

{
  "id": "aig_abc123",
  "object": "media.generation",
  "status": "pending",
  "created": 1703001244,
  "model": "google/gemini-3.1-flash-image-preview"
}

Опросите статус через GET /v1/media/{id}:

curl "https://polza.ai/api/v1/media/aig_abc123" \
  -H "Authorization: Bearer <POLZA_AI_API_KEY>"

Статусы

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

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

Советы

4K для печати

Для полиграфии и баннеров выбирайте image_resolution: "4K" — это максимальное качество модели.

Точный рендеринг текста

Nano Banana 2 хорошо рендерит текст на изображениях. Указывайте шрифт, размер и расположение в промпте.

Детализируйте освещение

Модель отлично обрабатывает сложные световые схемы — описывайте их подробно: студийный свет, боковое освещение, время суток.

Смотрите также

Попробовать в Playground

Тестируйте модель прямо в браузере без написания кода

Статус и результат генерации

GET /v1/media/{id} — проверка статуса задачи

Nano Banana

Базовая версия модели

Nano Banana Pro

Продвинутая версия с расширенными возможностями

Авторизации

Authorization

string

header

обязательно

API ключ передаётся в заголовке: Authorization: Bearer <POLZA_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

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

Maximum string length: 256

Пример:

"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

object

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

Option 1
Option 2
Option 3
Option 4
Option 5

Show child attributes

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

Начало работы

Продвинутое

Классификация и оценка

Генерация медиа

Интеграции

Характеристики

Примеры

Редактирование с референс-изображением

Ответ

Статусы

Советы

Смотрите также

Попробовать в Playground

Статус и результат генерации

Nano Banana

Nano Banana Pro

Авторизации

Тело

Ответ

​Характеристики

​Примеры

​Редактирование с референс-изображением

​Ответ

​Статусы

​Советы

​Смотрите также

Попробовать в Playground

Статус и результат генерации

Nano Banana

Nano Banana Pro

Авторизации

Тело

Ответ

Характеристики

Примеры

Редактирование с референс-изображением

Ответ

Статусы

Советы

Смотрите также