# Artany API

> Artany API provides unified developer APIs for AI image and video generation, with API keys, asynchronous jobs, and Credit-based billing.

One REST API for AI image and video generation. Fixed Credit pricing (1 Credit = $0.01)
frozen at submit, settled on success, fully refunded on failure. Async job model:
POST a generation, poll the job until it finishes, download results from our CDN.

## Integration basics

- Base URL: https://api.artany.ai/v1
- Auth: `Authorization: Bearer <API key>` (create keys in the console at /api-keys)
- Recommended header on generation requests: `Idempotency-Key: <unique 8-128 chars>`
- Every model shares one request/response contract; the job object is identical across models.

## Endpoints

- GET /v1/models — list public models with pricing metadata
- GET /v1/models/{model} — schema, defaults, and a sample request for one model
- POST /v1/credits/estimate — quote estimated and maximum Credits before generating
- GET /v1/credits/balance — workspace balance and frozen amount
- GET /v1/credits/transactions — workspace credit ledger
- POST /v1/images/generations — create a text-to-image job
- POST /v1/images/edits — create an image-editing job
- POST /v1/videos/generations — create text/image/reference video jobs
- POST /v1/videos/edits — create a video-editing job
- GET /v1/jobs/{jobId} — job status, output URLs, and final Credit settlement

## Job lifecycle

queued -> frozen (max charge held) -> processing -> succeeded | failed | canceled.
On succeeded the fixed catalog price is settled and any unused hold is refunded;
on failed/canceled the full hold is refunded automatically.

## Models

- artany-gpt-image-2 (Text to Image, from 6 Credits): https://api.artany.ai/models/artany-gpt-image-2
- artany-gpt-image-2-edit (Image to Image, from 6 Credits): https://api.artany.ai/models/artany-gpt-image-2-edit
- artany-kling-3 (Text to Video, from 12 Credits): https://api.artany.ai/models/artany-kling-3
- artany-kling-3-i2v (Image to Video, from 12 Credits): https://api.artany.ai/models/artany-kling-3-i2v
- artany-nano-banana (Text to Image, from 9 Credits): https://api.artany.ai/models/artany-nano-banana
- artany-nano-banana-2 (Text to Image, from 15 Credits): https://api.artany.ai/models/artany-nano-banana-2
- artany-nano-banana-2-edit (Image to Image, from 15 Credits): https://api.artany.ai/models/artany-nano-banana-2-edit
- artany-nano-banana-edit (Image to Image, from 9 Credits): https://api.artany.ai/models/artany-nano-banana-edit
- artany-nano-banana-pro (Text to Image, from 30 Credits): https://api.artany.ai/models/artany-nano-banana-pro
- artany-nano-banana-pro-edit (Image to Image, from 30 Credits): https://api.artany.ai/models/artany-nano-banana-pro-edit
- artany-seedance-2 (Text to Video, from 13 Credits): https://api.artany.ai/models/artany-seedance-2
- artany-seedance-2-fast (Text to Video, from 9 Credits): https://api.artany.ai/models/artany-seedance-2-fast
- artany-seedance-2-fast-i2v (Image to Video, from 9 Credits): https://api.artany.ai/models/artany-seedance-2-fast-i2v
- artany-seedance-2-i2v (Image to Video, from 13 Credits): https://api.artany.ai/models/artany-seedance-2-i2v
- artany-seedream-4-5 (Text to Image, from 12 Credits): https://api.artany.ai/models/artany-seedream-4-5
- artany-seedream-4-5-edit (Image to Image, from 12 Credits): https://api.artany.ai/models/artany-seedream-4-5-edit
- artany-seedream-5 (Text to Image, from 12 Credits): https://api.artany.ai/models/artany-seedream-5
- artany-seedream-5-edit (Image to Image, from 12 Credits): https://api.artany.ai/models/artany-seedream-5-edit
- artany-veo-3-1-fast (Text to Video, from 17 Credits): https://api.artany.ai/models/artany-veo-3-1-fast
- artany-veo-3-1-fast-i2v (Image to Video, from 17 Credits): https://api.artany.ai/models/artany-veo-3-1-fast-i2v
- artany-veo-3-1-pro (Text to Video, from 26 Credits): https://api.artany.ai/models/artany-veo-3-1-pro
- artany-veo-3-1-pro-i2v (Image to Video, from 26 Credits): https://api.artany.ai/models/artany-veo-3-1-pro-i2v
- artany-video-fast (Text to Video, from 5 Credits): https://api.artany.ai/models/artany-video-fast
- artany-video-fast-i2v (Image to Video, from 5 Credits): https://api.artany.ai/models/artany-video-fast-i2v
- artany-video-plus (Text to Video, from 8 Credits): https://api.artany.ai/models/artany-video-plus
- artany-video-plus-i2v (Image to Video, from 8 Credits): https://api.artany.ai/models/artany-video-plus-i2v
- artany-video-pro (Text to Video, from 11 Credits): https://api.artany.ai/models/artany-video-pro
- artany-video-pro-i2v (Image to Video, from 11 Credits): https://api.artany.ai/models/artany-video-pro-i2v
- artany-z-image-turbo (Text to Image, from 1 Credits): https://api.artany.ai/models/artany-z-image-turbo
- artany-z-image-turbo-edit (Image to Image, from 1 Credits): https://api.artany.ai/models/artany-z-image-turbo-edit

## Docs

- [API documentation](https://api.artany.ai/docs): authentication, endpoints, lifecycle, errors, code samples
- [Model market](https://api.artany.ai/models): browse all models with live playground
- [Pricing](https://api.artany.ai/pricing): per-model Credit price tables
- [Console](https://api.artany.ai/dashboard): keys, usage, billing