Quickstart

This guide takes you from a new account to a working SnapGen request.

Step 1: Get an API key

Create a SnapGen account.
Add prepaid balance under Console > Billing.
Open Console > API Keys and create a key.
Store the key in a server-side environment variable.

export SNAPGEN_API_KEY="sk-xxxx"

Step 2: Choose a model

List the models available to your key:

curl https://api.snapgen.org/v1/models \
  -H "Authorization: Bearer $SNAPGEN_API_KEY"

Start with one of these routes:

Modality	Model	Price
Text	`gpt-5.4-mini`	$0.25 input /$ 1.50 output per 1M tokens
Image	`gpt-image-2`	$0.01 per image
Video	`gemini-omni-t2v`	$0.25 per 10-second request

Step 3: Send a request

curl https://api.snapgen.org/v1/chat/completions \
  -H "Authorization: Bearer $SNAPGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-mini",
    "messages": [{"role": "user", "content": "Write one welcome sentence."}]
  }'

curl https://api.snapgen.org/v1/images/generations \
  -H "Authorization: Bearer $SNAPGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A clean indigo paper lantern on a white background",
    "size": "1024x1024"
  }'

curl https://api.snapgen.org/v1/videos \
  -H "Authorization: Bearer $SNAPGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-omni-t2v",
    "prompt": "A paper airplane glides through a sunlit library",
    "seconds": "10",
    "size": "1280x720"
  }'

Text and image requests return their content directly. Video requests return a task id because generation is asynchronous.

Step 4: Check a video task

curl "https://api.snapgen.org/v1/videos/$VIDEO_ID?model=gemini-omni-t2v" \
  -H "Authorization: Bearer $SNAPGEN_API_KEY"

When the status becomes completed, download the file:

curl -L "https://api.snapgen.org/v1/videos/$VIDEO_ID/content?model=gemini-omni-t2v" \
  -H "Authorization: Bearer $SNAPGEN_API_KEY" \
  --output video.mp4

Next steps

Model pages

Review exact parameters and prices for every live model.

Development tools

Connect Claude Code, Cursor, Cline, Gemini CLI, or Codex CLI.

Video workflow

Build reliable polling, download, and webhook handling.

Error handling

Recover from authentication, quota, rate-limit, and upstream errors.

Getting Started

Development Guide

Step 1: Get an API key

Step 2: Choose a model

Step 3: Send a request

Step 4: Check a video task

Next steps

Model pages

Development tools

Video workflow

Error handling

​Step 1: Get an API key

​Step 2: Choose a model

​Step 3: Send a request

​Step 4: Check a video task

​Next steps

Model pages

Development tools

Video workflow

Error handling

Step 1: Get an API key

Step 2: Choose a model

Step 3: Send a request

Step 4: Check a video task

Next steps