Quickstart

Generate your first AI video or image in under 60 seconds.

Prerequisites

• A Veogen account at veogen.studio
• An API token (see Authentication)
• At least $0.30 balance ([top up](https://veogen.studio/billing)) — or use the free$0.05 included on signup for an image generation

---

Step 1 — Generate an Image (Free with $0.05 signup balance)

Generate an image with GPT-4o Image ($0.02) using your free signup balance:

curl -X POST https://veogen.studio/api/v1/generations \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "model": "gpt-4o-image",
    "prompt": "A futuristic cityscape at sunset with flying cars and neon lights",
    "aspect_ratio": "16:9"
  }'

Response 201 Created:

{
    "data": {
        "id": "01928abc-def0-7123-b456-789012345678",
        "status": "pending",
        "model": "gpt-4o-image",
        "type": "image",
        "prompt": "A futuristic cityscape at sunset with flying cars and neon lights",
        "parameters": {
            "aspect_ratio": "16:9"
        },
        "output": null,
        "error": null,
        "created_at": "2025-01-15T10:30:00+00:00",
        "completed_at": null
    },
    "price_usd": 0.02
}

---

Step 2 — Poll for Completion

Use the id from the response to check status:

curl https://veogen.studio/api/v1/generations/01928abc-def0-7123-b456-789012345678 \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"

Status values:

Status	Meaning
pending	Queued — waiting to start
processing	Running on the model
completed	Done — output.url is ready
failed	Error — check error field. You were not charged.

Completed response:

{
    "data": {
        "id": "01928abc-def0-7123-b456-789012345678",
        "status": "completed",
        "model": "gpt-4o-image",
        "type": "image",
        "prompt": "A futuristic cityscape at sunset with flying cars and neon lights",
        "parameters": {
            "aspect_ratio": "16:9"
        },
        "output": {
            "url": "https://veogen.studio/storage/generations/01928abc.png",
            "content_type": "image/png"
        },
        "error": null,
        "created_at": "2025-01-15T10:30:00+00:00",
        "completed_at": "2025-01-15T10:30:08+00:00"
    }
}

---

Step 3 — Generate a Video

With $0.30+ balance, generate a video with Veo 3.1 Fast:

curl -X POST https://veogen.studio/api/v1/generations \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "model": "veo-3.1-fast",
    "prompt": "A golden retriever running through a field of sunflowers at sunset, cinematic slow motion",
    "aspect_ratio": "16:9",
    "resolution": "1080p"
  }'

Video generations typically take 30–120 seconds. Poll the status endpoint every 5 seconds.

---

Using Image-to-Video

Pass an image_urls array to use your image as the first frame:

curl -X POST https://veogen.studio/api/v1/generations \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "model": "veo-3.1-fast",
    "prompt": "Camera slowly pulls back to reveal the full scene",
    "aspect_ratio": "16:9",
    "image_urls": ["https://example.com/my-image.jpg"]
  }'

---

Next Steps

Browse all models

Find the right model for your use case and check live pricing.

Create Generation

Full parameter reference for the create endpoint.