API DOCUMENTATION

42rows API — Quickstart.

Generate ad-ready creative via REST. Authenticate with a key, POST a prompt, get back a job id. Result lands in ~30s for image, ~60s for 3D, ~3 min for video.

No SDK required — it's plain JSON over HTTPS.

Get an API key

Create a free account, then issue an API key from your dashboard. Free tier includes 10 generations/month. No credit card required.

Create account Already have one? Sign in

Keys look like 42r_sk_a1b2c3d4_xK9pV... and are shown only once at creation. Store securely (env var, secret manager).

Make your first call

Submit a generation. Returns a job id immediately — the asset is produced asynchronously.

curl -X POST https://42rows.com/api/v1/tools/generate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer 42r_sk_YOUR_KEY" \
  -d '{
    "prompt": "LinkedIn sponsored post for a fintech SaaS, headline \"Market-Leading Precision\", stat \"+12.4%\", CTA \"Download Insights\"",
    "type": "image"
  }'

Response

{
  "id": "a3f4e7b2-9c1d-4e8f-b0a2-7d3c8f1e9b4a",
  "slug": "linkedin-sponsored-post-fintech-saas",
  "queuePosition": 0,
  "estimatedWait": "30s",
  "status": "queued"
}

Then poll GET /api/v1/tools/my-generations until status === "completed", and download via GET /api/v1/tools/my-generations/{id}/file.

Endpoint reference

POST /api/v1/tools/generate

Submit a new generation. Returns a job id immediately; result is async.

{ prompt: string, type: "image" | "video" | "3d", imageUrl?: string }

GET /api/v1/tools/my-generations

List your recent generations with status and final URL when ready.

Query: ?limit=20&type=image

GET /api/v1/tools/my-generations/{id}/file

Download the generated asset (PNG / MP4 / GLB).

POST /api/v1/api-keys

Create a new API key. Save the response — full key shown only once. Max 5 active.

{ name?: string }

All endpoints accept either JWT (from POST /api/v1/auth/login) or API key (from POST /api/v1/api-keys) in the Authorization: Bearer header.

What you can generate

Actor	`type`	Formats	Tiers	Price
Image Creative	`"image"`	1080×1080, 1200×628, 1080×1920	flat	$0.20 / call
Video Creative	`"video"`	MP4 4–8s, 16:9 / 9:16, 720p–1080p	flat	$1.50 / call
3D Creative	`"3d"`	GLB, STL, OBJ, PLY	lite / standard / high / ultra	$0.08 – $1.50

Subscription plans (Builder $19, Growth $99, Scale $399) include monthly quotas with overage at retail rates above. Pay-as-you-go available without subscription.

Try without signing up

The Playground lets you generate one asset of each type without an account. Useful to validate output quality before integrating.

Open the playground

Errors you'll see

Status	Meaning	Action
`401`	Missing or invalid API key	Check `Authorization` header
`402`	Insufficient credits	Upgrade plan or top up — see body `error.upgrade_url`
`403`	Captcha required (anonymous calls only)	Authenticate with API key to skip
`422`	Validation error (prompt too short, invalid type)	Check body schema
`429`	Already a generation of that type in queue	Wait, then retry

On 402, response body includes current_balance, required, operation, upgrade_url. Header X-Credits-Remaining is set on every billed response.