Models API

Generate and edit images using Vydra's AI models. Each model has different capabilities, pricing, and use cases.

Available Models

Gemini 2.0 Flash

Google's fast image generation model. Great for quick text-to-image generation.

5 credits

Text-to-image10 aspect ratios

Generate Edit

Nano Banana

Google's Gemini 2.5 Flash with native image generation. Higher quality, supports both generation and editing.

8 credits

Text-to-imageImage editing10 aspect ratios

Generate / Edit

Model Car

Transform any car photo into a collectible 1/7 scale BANDAI-style figurine using AI.

8 credits

Image editingDefault prompt10 aspect ratios

Workflow

Flux 2 Edit

Fal.ai's powerful multi-image composition model. Combine up to 9 reference images.

15 credits

Multi-image compositionUp to 9 imagesGuidance scale control

Edit

Grok Imagine

xAI's official image and video generation. Text-to-image (8 credits), text-to-video (150 credits), image-to-video (150 credits).

150 credits

Text-to-videoText-to-imageImage-to-video

Generate

Common Parameters

Aspect Ratios

Most models support the following aspect ratios:

1:1

2:3

3:2

3:4

4:3

4:5

5:4

9:16

16:9

21:9

Default Aspect Ratio

If not specified, most models default to 1:1 (square).

Credit Pricing

Model	Credits per Image	Best For
Gemini 2.0 Flash	5	Quick generation, prototyping
Nano Banana	8	Higher quality, editing
Model Car	8	Figurine-style car transformations
Flux 2 Edit	15	Multi-image composition
ASMR Generator	150	ASMR video generation (Veo3)
Grok Imagine (video)	150	Text/image-to-video (xAI)
Grok Imagine (image)	8	Text-to-image (xAI)

Response Format

All model endpoints return a consistent response format:

Success Response

{
  "imageUrl": "https://pub-xxx.r2.dev/generated/...",
  "mimeType": "image/png",
  "creditsCharged": 5,
  "durationMs": 3420
}

Field	Type	Description
`imageUrl`	`string`	Public URL of the generated image
`mimeType`	`string`	Image format (usually image/png)
`creditsCharged`	`number`	Credits deducted for this request
`durationMs`	`number`	Processing time in milliseconds

Quick Start

Generate your first image with a single API call:

Generate an imagePOST

curl -X POST https://vydra.ai/api/v1/models/gemini/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A serene Japanese garden with cherry blossoms",
    "aspectRatio": "16:9"
  }'