🚀 Quickstart in 60 Seconds
Start generating images in 3 simple steps without complex onboarding:
Launch our official bot @VIDEOSTO_RE_bot and tap 🔑 My API Key. You receive an instant lifetime key with complimentary starter quota.
Activate Pro (10 concurrent streams, 500 images/day) or Enterprise (20 concurrent streams, 2,000 images/day) via instant crypto or card checkout.
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:
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.
/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). |
/v1/models
Retrieves the live list of neural network models currently available to your API key based on your active plan and permissions.
curl https://api.videosto.re/v1/models \ -H "Authorization: Bearer sk-YOUR_API_KEY"
{
"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:
State-of-the-Art photorealism, exquisite micro-textures, complex lighting, human anatomy fidelity, and flawless text in image rendering.
Ultra-fast artistic powerhouse with high color vibrancy, dynamic stylized rendering, and instant prompt adherence.
AI super-resolution enhancement that reconstructs sharp edges, cleans compression artifacts, and upscales images up to 4K.
Rock-solid enterprise image generation with balanced prompt following and high visual consistency.
Lightweight ultra-fast models designed for rapid creative exploration, real-time apps, and high-volume batch workloads.
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 |
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:
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.
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 |