# AdSkull API

> Create AI ads, voiceovers, images, videos, and talking avatars from any app, workflow, or automation tool.

## Docs

- [Introduction](https://docs.adskull.io/public/introduction.md): Use AdSkull's API to generate AI ad assets from your own app or workflow stack.
- [Base URL](https://docs.adskull.io/public/base-url.md): API host, versioning, content types, and request basics.
- [Quickstart](https://docs.adskull.io/public/quickstart.md): Create your first AdSkull API job and poll until the asset is ready.
- [Authentication](https://docs.adskull.io/public/authentication.md): Authenticate public API calls with scoped API keys.
- [Images](https://docs.adskull.io/public/feature-images.md): Generate AI images across 15 models with full ratio and quality control.
- [Videos](https://docs.adskull.io/public/feature-videos.md): Generate, edit, extend, and motion-control AI videos.
- [Voiceover](https://docs.adskull.io/public/feature-voiceover.md): Generate speech audio with text-to-speech (TTS) or speech-to-speech (STS).
- [Custom Voices](https://docs.adskull.io/public/feature-custom-voices.md): Clone a voice from audio or design a voice from a description.
- [Talking Avatars](https://docs.adskull.io/public/feature-talking-avatars.md): Lip-sync a still avatar image to a script or to an existing audio file.
- [LLMs](https://docs.adskull.io/public/feature-llm.md): Use 12 frontier text/multimodal models behind one API: Claude Opus 4.7 / 4.6, Claude Sonnet 4.6, GPT-5 nano / mini, GPT-5.4 nano, GPT-4.1 mini, and Gemini 3.1 / 3 Pro / 3 Flash / 2.5 Pro / 2.5 Flash.
- [LLM Chat (Native)](https://docs.adskull.io/public/feature-llm-chat.md): Send chat-style messages to any of the 12 LLMs through a single AdSkull-native endpoint.
- [LLM Multimodal Helpers](https://docs.adskull.io/public/feature-llm-multimodal.md): One-call vision, audio, and video analysis with structured JSON output. No prompts required.
- [OpenAI-compatible API](https://docs.adskull.io/public/feature-llm-openai-compat.md): Drop AdSkull into any OpenAI SDK or OpenAI-shaped tool by setting base_url. Works with Cline, Roo Code, Continue, Aider, Cursor, OpenWebUI, LiteLLM, LangChain, n8n, and more.
- [Anthropic-compatible API](https://docs.adskull.io/public/feature-llm-anthropic-compat.md): Use Claude Code, openclaw, and any Anthropic SDK with AdSkull by changing ANTHROPIC_BASE_URL.
- [Integrations](https://docs.adskull.io/public/integrations.md): Plug AdSkull into every coding agent, AI app, and automation tool that accepts a custom API endpoint.
- [Account And Credits](https://docs.adskull.io/public/account-and-credits.md): Check plan access, remaining credits, usage, rate limits, and voice quota.
- [Credits And Pricing](https://docs.adskull.io/public/credits-and-pricing.md): Understand credits, plans, and generation costs.
- [Models & Options](https://docs.adskull.io/public/models.md): Every model AdSkull exposes, with the full matrix of supported parameters.
- [Responses](https://docs.adskull.io/public/responses.md): Success, job, list, asset, and error response shapes.
- [Errors](https://docs.adskull.io/public/errors.md): AdSkull API error envelope and common error codes.
- [Rate Limits](https://docs.adskull.io/public/rate-limits.md): Understand request, job, and account limits.
- [Security](https://docs.adskull.io/public/security.md): How to use AdSkull API keys safely.
- [Webhooks](https://docs.adskull.io/public/webhooks.md): Receive completion events instead of polling every job.
- [Get remaining AI credits and voice quota](https://docs.adskull.io/api-reference/account/get-remaining-ai-credits-and-voice-quota.md)
- [Get account usage and credits](https://docs.adskull.io/api-reference/account/get-account-usage-and-credits.md)
- [Get account plan](https://docs.adskull.io/api-reference/account/get-account-plan.md)
- [List available models and product options](https://docs.adskull.io/api-reference/models/list-available-models-and-product-options.md)
- [Get full options for one model](https://docs.adskull.io/api-reference/models/get-full-options-for-one-model.md): Returns the full per-model option matrix: ratios, resolutions, durations, tiers, qualities, audio behavior, input requirements, extension support, and inline orientation examples. Use this before calling a generation endpoint to know exactly which values the model accepts.
- [List credit costs](https://docs.adskull.io/api-reference/models/list-credit-costs.md)
- [Upload an asset for later generation requests](https://docs.adskull.io/api-reference/assets/upload-an-asset-for-later-generation-requests.md)
- [List image generation jobs](https://docs.adskull.io/api-reference/images/list-image-generation-jobs.md)
- [Create an AI image generation job](https://docs.adskull.io/api-reference/images/create-an-ai-image-generation-job.md)
- [Get an image generation job](https://docs.adskull.io/api-reference/images/get-an-image-generation-job.md)
- [List video generation jobs](https://docs.adskull.io/api-reference/videos/list-video-generation-jobs.md)
- [Create an AI video generation job](https://docs.adskull.io/api-reference/videos/create-an-ai-video-generation-job.md)
- [Get a video generation job](https://docs.adskull.io/api-reference/videos/get-a-video-generation-job.md)
- [Extend a supported video generation](https://docs.adskull.io/api-reference/videos/extend-a-supported-video-generation.md)
- [List AdSkull voice library](https://docs.adskull.io/api-reference/voices/list-adskull-voice-library.md)
- [List voice generations](https://docs.adskull.io/api-reference/voices/list-voice-generations.md)
- [Generate voice audio](https://docs.adskull.io/api-reference/voices/generate-voice-audio.md)
- [Get a voice generation](https://docs.adskull.io/api-reference/voices/get-a-voice-generation.md)
- [List custom voices](https://docs.adskull.io/api-reference/voices/list-custom-voices.md)
- [Clone a custom voice from audio](https://docs.adskull.io/api-reference/voices/clone-a-custom-voice-from-audio.md)
- [Design a custom voice from description](https://docs.adskull.io/api-reference/voices/design-a-custom-voice-from-description.md)
- [Delete a custom voice](https://docs.adskull.io/api-reference/voices/delete-a-custom-voice.md)
- [List talking avatar jobs](https://docs.adskull.io/api-reference/talking-avatars/list-talking-avatar-jobs.md)
- [Create a talking avatar job](https://docs.adskull.io/api-reference/talking-avatars/create-a-talking-avatar-job.md)
- [Get a talking avatar job](https://docs.adskull.io/api-reference/talking-avatars/get-a-talking-avatar-job.md)
- [List webhook endpoints](https://docs.adskull.io/api-reference/webhooks/list-webhook-endpoints.md)
- [Create a webhook endpoint](https://docs.adskull.io/api-reference/webhooks/create-a-webhook-endpoint.md)
- [Delete a webhook endpoint](https://docs.adskull.io/api-reference/webhooks/delete-a-webhook-endpoint.md)
- [List LLM models](https://docs.adskull.io/api-reference/llm/list-llm-models.md): Returns the catalog of available LLMs and per-million-token pricing.
- [List recent LLM calls](https://docs.adskull.io/api-reference/llm/list-recent-llm-calls.md)
- [Native chat completion](https://docs.adskull.io/api-reference/llm/native-chat-completion.md): Single, stable shape across every AdSkull LLM. Optional SSE streaming.
- [Describe an image with structured JSON output](https://docs.adskull.io/api-reference/llm/describe-an-image-with-structured-json-output.md)
- [Transcribe audio with structured JSON output](https://docs.adskull.io/api-reference/llm/transcribe-audio-with-structured-json-output.md)
- [Describe a video with shots, OCR, and transcript](https://docs.adskull.io/api-reference/llm/describe-a-video-with-shots-ocr-and-transcript.md)
- [OpenAI-compatible list of available LLMs](https://docs.adskull.io/api-reference/llm-openai-compat/openai-compatible-list-of-available-llms.md)
- [OpenAI-compatible chat completion](https://docs.adskull.io/api-reference/llm-openai-compat/openai-compatible-chat-completion.md): Use this with any OpenAI SDK, Cline, Roo Code, Continue, Aider, Cursor, LiteLLM, LangChain, n8n, OpenWebUI, etc.
- [Anthropic-compatible messages endpoint](https://docs.adskull.io/api-reference/llm-anthropic-compat/anthropic-compatible-messages-endpoint.md): Use this with Claude Code, openclaw, and any Anthropic SDK by changing ANTHROPIC_BASE_URL.
- [Changelog](https://docs.adskull.io/public/changelog.md): New features, updates, and fixes shipped to the AdSkull API.

## OpenAPI Specs

- [openapi](https://docs.adskull.io/api/openapi.yaml)