Enterprise AI Studio & REST API

Official developer documentation for high-concurrency image generation. Built on 100% OpenAI-compatible specifications with multi-stream GPU pipelines, sub-second queues, and global CDN delivery.

Base URL: https://api.videosto.re

🚀 Quickstart in 60 Seconds

Start generating images in 3 simple steps without complex onboarding:

1. Get API Key Telegram

Launch our official bot @VIDEOSTO_RE_bot and tap 🔑 My API Key. You receive an instant lifetime key with complimentary starter quota.

2. Choose Streams Tariffs

Activate Pro (10 concurrent streams, 500 images/day) or Enterprise (20 concurrent streams, 2,000 images/day) via instant crypto or card checkout.

3. Send Request OpenAI SDK

Point your existing code or agent to https://api.videosto.re/v1. No custom SDK required — compatible with standard OpenAI libraries in all programming languages.

🔑 Authentication

Authenticate all API requests by providing your API key in the Authorization HTTP header using the standard Bearer scheme:

HTTP Header Specification
Authorization: Bearer sk-YOUR_API_KEY_HERE

⚡ Live Key & Quota Sandbox

Verify your API key, check active models, and test latency directly from your browser. Your key is tested securely via HTTPS and is never stored on any server.

Test API Key Connection:
POST

/v1/images/generations

Creates one or more high-fidelity images from a detailed natural language prompt. Supports multimodal styling, custom aspect ratios, and ultra-fast generation.

curl https://api.videosto.re/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -d '{
    "model": "gpt-image-2.5",
    "prompt": "Futuristic cyberpunk neon metropolis at rainy midnight, ultra-detailed 8K reflections, cinematic lighting",
    "size": "1024x1024",
    "response_format": "url",
    "n": 1
  }'

Request Parameters

Parameter Type Required Description
model string Yes Model identifier: gpt-image-2.5, nano-banana-pro, gpt-image-2, nano-banana, banana-upscale, etc.
prompt string Yes Text description of the desired image. Supports English, Russian, and all major languages (up to 4,000 characters).
size string No (default 1024x1024) Resolution: 1024x1024 (1:1), 1792x1024 (16:9), 1024x1792 (9:16), 1024x768 (4:3), 768x1024 (3:4).
response_format string No (default "url") Output encoding: "url" (direct CDN image link) or "b64_json" (raw Base64 data).
n integer No (default 1) Number of images to generate (currently 1 per API call).
GET

/v1/models

Retrieves the live list of neural network models currently available to your API key based on your active plan and permissions.

HTTP GET Request
curl https://api.videosto.re/v1/models \
  -H "Authorization: Bearer sk-YOUR_API_KEY"
Example Response (200 OK)
{
  "object": "list",
  "data": [
    { "id": "gpt-image-2.5", "object": "model", "owned_by": "videostore" },
    { "id": "nano-banana-pro", "object": "model", "owned_by": "videostore" },
    { "id": "gpt-image-2", "object": "model", "owned_by": "videostore" },
    { "id": "nano-banana", "object": "model", "owned_by": "videostore" },
    { "id": "banana-upscale", "object": "model", "owned_by": "videostore" },
    { "id": "nano-banana-2.1", "object": "model", "owned_by": "videostore" },
    { "id": "nano-banana-2", "object": "model", "owned_by": "videostore" },
    { "id": "gpt-image-2.5-flare", "object": "model", "owned_by": "videostore" },
    { "id": "gpt-image-2.5-sunburst", "object": "model", "owned_by": "videostore" }
  ]
}

🧠 Model Catalog & Capabilities

Compare specifications, generation latency, and recommended use cases for our production models:

GPT Image 2.5 Flagship
ID: gpt-image-2.5 • Avg: 12-24s

State-of-the-Art photorealism, exquisite micro-textures, complex lighting, human anatomy fidelity, and flawless text in image rendering.

Nano Banana Pro Speed & Style
ID: nano-banana-pro • Avg: 8-15s

Ultra-fast artistic powerhouse with high color vibrancy, dynamic stylized rendering, and instant prompt adherence.

Banana Upscale 4K Super-Resolution
ID: banana-upscale • Avg: 10-18s

AI super-resolution enhancement that reconstructs sharp edges, cleans compression artifacts, and upscales images up to 4K.

GPT Image 2.0 Classic
ID: gpt-image-2 • Avg: 10-20s

Rock-solid enterprise image generation with balanced prompt following and high visual consistency.

Nano Banana 2.1 / 2 Throughput
ID: nano-banana-2.1, nano-banana-2 • Avg: 6-12s

Lightweight ultra-fast models designed for rapid creative exploration, real-time apps, and high-volume batch workloads.

Video & Audio AI (Upcoming) Roadmap
Veo 3.1, Runway, Kling, Seedance

Next-generation generative video and voice synthesis will be activated under the exact same unified API key and subscription pool!

📐 Supported Aspect Ratios & Resolutions

Specify the size parameter in your payload to match your target platform perfectly:

Ratio Resolution (WxH) Target Media / Use Case
1:1 1024x1024 Square — Instagram posts, avatars, product cards, e-commerce
16:9 1792x1024 Landscape — YouTube thumbnails, website banners, desktop wallpapers
9:16 1024x1792 Portrait / Reels — TikTok, Instagram Stories, YouTube Shorts, mobile wallpapers
4:3 1024x768 Classic Wide — Presentations, digital art, blog illustrations
3:4 768x1024 Classic Portrait — Book covers, magazine prints, posters

⚡ Concurrency, Streams & Rate Limits

Each subscription plan is calibrated with dedicated parallel hardware streams and daily quota resets:

Tariff Plan Concurrent Streams Daily Allowance Reset Policy
Starter Free 1 stream 10 images lifetime One-time test allowance
Pro 500/day 10 parallel streams 500 images / 24 hours Every 24h at 00:00 UTC
Enterprise 2000/day 20 parallel streams 2,000 images / 24 hours Every 24h at 00:00 UTC
⚠️ Concurrency Semaphore Best Practice:

If you dispatch more simultaneous requests than your plan allows, you will receive HTTP 429 (Concurrency limit exceeded). In high-throughput bots or scripts, wrap requests in an asynchronous semaphore (e.g. asyncio.Semaphore(10)) to match your purchased streams smoothly.

💾 Storage, Download & CDN Retention

Understanding output URLs, caching, and recommended download workflows:

24-Hour CDN Retention CDN

Images returned via response_format: "url" are served from our edge CDN with lightning-fast download speeds. Links remain active for 24 hours. We recommend downloading and storing results to your own permanent S3/storage directly upon receiving the response.

Direct Base64 Transfer b64_json

If your application requires immediate in-memory processing without downloading from external URLs, request "response_format": "b64_json" to receive the raw image binary bytes directly in the JSON response.

⚠️ Error Codes & Diagnostics

Standard HTTP status codes and actionable remedies:

Status Error Type Cause Recommended Action
200 OK Success Generation finished successfully Parse image URL or Base64 payload
401 Invalid API Key Missing or incorrect Authorization header Check key spelling; obtain valid key in @VIDEOSTO_RE_bot
402 / 429 Quota Exceeded Daily generation limit reached or out of credits Wait for midnight reset (00:00 UTC) or upgrade in bot
429 Concurrency Limit More parallel requests than allowed streams Implement client semaphore; wait for in-flight jobs to finish
400 Bad Request Unsupported model name, invalid size or empty prompt Check model catalog and resolution specifications
504 Gateway Timeout GPU worker cluster took longer than expected Set client HTTP timeout to 120-180 seconds; retry with backoff