Developers

Public API v1 — search, metadata, image & video generation

Quick start

Create an API key in dashboard settings.
Read OpenAPI from /api/v1/openapi.json.
Call endpoints with a Bearer token; use write:generations scope for jobs.

Image generation (write)

Server must have PUBLIC_API_WRITE_ENABLED=true. Credits debit the key owner's wallet.

POST /api/v1/generations
Authorization: Bearer axeto_...
Content-Type: application/json

{
  "type": "image",
  "model": "flux-pro",
  "prompt": "A cinematic poster..."
}

Video generation (write)

Set type to video with a Seedance model slug. Params: duration, resolution, aspectRatio.

POST /api/v1/generations
{
  "type": "video",
  "model": "seedance-1-pro",
  "prompt": "Slow pan over a city at dusk",
  "params": { "duration": 5, "resolution": "720p" }
}

Authentication

All write requests require Authorization: Bearer <api_key>. Keys are created in the dashboard with scoped permissions.

API pricing

Each generation debits the user's wallet credits. See /pricing for credit-to-toman rates.

API pricing

Rate limits

Default: 60 requests/min per API key. Generation jobs are async — poll GET /api/v1/generations/:id.

Error codes

401 UNAUTHORIZED · 403 FORBIDDEN · 402 INSUFFICIENT_CREDITS · 429 RATE_LIMIT · 503 WRITE_DISABLED

Webhooks

Register webhooks in dashboard settings. Events: generation.completed, generation.failed, sale.created, payout.approved. Verify X-Axeto-Signature (HMAC-SHA256).

Events

generation.completed · generation.failed · sale.created · payout.approved