# VelvetAPI

> Uncensored image generation API for adult platforms (18+). Create a task with a model, its input and your end user's id, then poll it or receive a signed webhook. Prepaid per-image pricing; failed jobs are refunded.

- API base URL: https://api.velvetapi.dev
- Authentication: `Authorization: Bearer vk_...` with an API key from the console. Keep keys server-side.
- OpenAPI 3.1 document: https://velvetapi.dev/openapi.json
- Console (keys, billing, playground): https://velvetapi.dev/console/

## Docs

- [Quickstart](https://velvetapi.dev/docs/quickstart/): get an API key, create a task, and poll it until the images are ready
- [Authentication](https://velvetapi.dev/docs/authentication/): API keys, keeping them server-side, and per-key monthly spending caps
- [Tasks and webhooks](https://velvetapi.dev/docs/tasks/): task states, polling, idempotency keys, cancelling, and verifying signed webhooks
- [Models](https://velvetapi.dev/docs/models/): the models, their prices and their input schemas
- [Billing](https://velvetapi.dev/docs/billing/): prepaid credits, holds and refunds, top-ups, invoices and statements
- [Content policy and safety](https://velvetapi.dev/docs/safety/): what may be generated, prompt screening, end-user strikes, output checks and reports
- [Errors](https://velvetapi.dev/docs/errors/): error types, HTTP statuses and what to do about each
- [SDKs](https://velvetapi.dev/docs/sdks/): the TypeScript (@velvetapi/sdk) and Python (velvetapi) clients
- [API reference](https://velvetapi.dev/docs/api-reference/): every endpoint, generated from the OpenAPI document

## Models

- [FLUX 3 Image Klein](https://velvetapi.dev/models/flux-3-klein/): model id `flux-3-klein`; $0.01 per image plus $0.004 per reference image; text to image, image editing; runs on VelvetAPI's GPUs. Black Forest Labs' step-distilled FLUX 3 Klein on VelvetAPI's own GPUs: text to image, and edits from up to ten of your own generated images.
- [Z-Image Turbo](https://velvetapi.dev/models/z-image-turbo/): model id `z-image-turbo`; $0.006 per image; text to image; runs on VelvetAPI's GPUs. Tongyi-MAI's 8-step distilled Z-Image Turbo on VelvetAPI's own GPUs: fast, photorealistic text to image.
- [Qwen Image 3.0](https://velvetapi.dev/models/qwen-image-3.0/): model id `qwen-image-3.0`; $0.035 per image plus $0.004 per reference image; text to image, image editing; resold from the publisher's API. Alibaba's Qwen Image 3.0 through Alibaba Cloud Model Studio: text to image, or edits combining up to three of your images, with strong text rendering. Model Studio's content moderation applies, so explicit requests are refused.
- [Qwen Image 3.0 Pro](https://velvetapi.dev/models/qwen-image-3.0-pro/): model id `qwen-image-3.0-pro`; $0.045 per image plus $0.004 per reference image; text to image, image editing; resold from the publisher's API. Alibaba's flagship Qwen Image 3.0 Pro through Alibaba Cloud Model Studio: finer detail and text than Qwen Image 3.0, up to 2.25 megapixels. Model Studio's content moderation applies, so explicit requests are refused.
- [Seedream 5.0 Pro](https://velvetapi.dev/models/seedream-5.0-pro/): model id `seedream-5.0-pro`; $0.05 per image plus $0.004 per reference image; text to image, image editing; resold from the publisher's API. ByteDance's Seedream 5.0 Pro through BytePlus ModelArk: one image per task, from text or up to ten of your images. BytePlus's content moderation applies, so explicit requests are refused.

## Endpoints

- `POST /v1/tasks`: Create a generation task
- `GET /v1/tasks`: List your tasks, newest first
- `GET /v1/tasks/{id}`: Get a task
- `POST /v1/tasks/{id}/cancel`: Cancel a task and refund its hold
- `GET /v1/models`: List models with their input schemas and prices
- `GET /v1/models/{id}`: Get one model
- `POST /v1/quotes`: Price a request without running it
- `GET /v1/account`: Your balance
- `POST /v1/reports`: Report an output (no account needed)

## Policies

- [Acceptable Use Policy](https://velvetapi.dev/legal/acceptable-use/): adults only; no minors, no real people without consent, no non-consensual content
- [Terms of Service](https://velvetapi.dev/legal/terms/)
- [Privacy Policy](https://velvetapi.dev/legal/privacy/)
- [Report content](https://velvetapi.dev/report/): public report form; non-consensual and child abuse reports are taken down immediately and reviewed within 48 hours

## Optional

- [Pricing](https://velvetapi.dev/pricing/): per-model prices and top-up limits ($10 to $2,000, card or USDT)
- [Status](https://velvetapi.dev/status/): live health check of https://api.velvetapi.dev/health