> ## Documentation Index
> Fetch the complete documentation index at: https://veogenstudio.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

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

## Prerequisites

* A Veogen account at [veogen.studio](https://veogen.studio)
* An API token (see [Authentication](/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:

```bash theme={null}
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`:

```json theme={null}
{
    "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:

```bash theme={null}
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:**

```json theme={null}
{
    "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:

```bash theme={null}
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"
  }'
```

<Note>
  Video generations typically take 30–120 seconds. Poll the status endpoint
  every 5 seconds.
</Note>

***

## Using Image-to-Video

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

```bash theme={null}
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

<CardGroup cols={2}>
  <Card title="Browse all models" icon="sparkles" href="/api-reference/models/list">
    Find the right model for your use case and check live pricing.
  </Card>

  <Card title="Create Generation" icon="plus" href="/api-reference/generations/create">
    Full parameter reference for the create endpoint.
  </Card>
</CardGroup>