> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.empiriolabs.ai/api-reference/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.empiriolabs.ai/_mcp/server.

# API Reference

## Docs

- [OpenRouter Model Listing](https://docs.empiriolabs.ai/openrouter-model-listing.md): Return model metadata in a denser per-token listing format

## API Docs

- API Reference > Models [List models](https://docs.empiriolabs.ai/api-reference/api-reference/models/list-models.md)
- API Reference > Models [Retrieve a model](https://docs.empiriolabs.ai/api-reference/api-reference/models/retrieve-model.md)
- API Reference > Text Generation > Chat Completions [Create a chat completion](https://docs.empiriolabs.ai/api-reference/api-reference/chat-completions/create-chat-completion.md)
- API Reference > Text Generation > Completions [Create a completion](https://docs.empiriolabs.ai/api-reference/api-reference/completions/create-completion.md)
- API Reference > Text Generation > Responses [Create a response](https://docs.empiriolabs.ai/api-reference/api-reference/responses/create-response.md)
- API Reference > Text Generation > Messages [Create a message](https://docs.empiriolabs.ai/api-reference/api-reference/messages/create-message.md)
- API Reference > Text Generation > Gemini [Generate content](https://docs.empiriolabs.ai/api-reference/api-reference/gemini/generate-content.md)
- API Reference > Text Generation > Gemini [Stream generate content](https://docs.empiriolabs.ai/api-reference/api-reference/gemini/stream-generate-content.md)
- API Reference > Text Generation > Gemini [Count tokens](https://docs.empiriolabs.ai/api-reference/api-reference/gemini/count-tokens.md)
- API Reference > Batch [Upload a batch file](https://docs.empiriolabs.ai/api-reference/api-reference/batch/create-batch-file.md)
- API Reference > Batch [Create a batch](https://docs.empiriolabs.ai/api-reference/api-reference/batch/create-batch.md)
- API Reference > Batch [Retrieve a batch](https://docs.empiriolabs.ai/api-reference/api-reference/batch/retrieve-batch.md)
- API Reference > Batch [List batches](https://docs.empiriolabs.ai/api-reference/api-reference/batch/list-batches.md)
- API Reference > Batch [Cancel a batch](https://docs.empiriolabs.ai/api-reference/api-reference/batch/cancel-batch.md)
- API Reference > Batch [Download a batch file](https://docs.empiriolabs.ai/api-reference/api-reference/batch/get-batch-file-content.md)
- API Reference > Embeddings [Create embeddings](https://docs.empiriolabs.ai/api-reference/api-reference/embeddings/create-embeddings.md)
- API Reference > Reranks [Rerank documents](https://docs.empiriolabs.ai/api-reference/api-reference/reranks/create-reranks.md)
- API Reference > Decisions [Create a decision](https://docs.empiriolabs.ai/api-reference/api-reference/decisions/create-decision.md)
- API Reference > Images [Generate an image](https://docs.empiriolabs.ai/api-reference/api-reference/images/create-image.md)
- API Reference > Images [Analyze an image](https://docs.empiriolabs.ai/api-reference/api-reference/images/analyze-image.md)
- API Reference > Images [Edit an image](https://docs.empiriolabs.ai/api-reference/api-reference/images/create-image-edit.md)
- API Reference > Generation Templates [List all templates](https://docs.empiriolabs.ai/api-reference/api-reference/generation-templates/list-generation-templates.md)
- API Reference > Generation Templates [Get a template](https://docs.empiriolabs.ai/api-reference/api-reference/generation-templates/get-generation-template.md)
- API Reference > Generation Templates [List video templates](https://docs.empiriolabs.ai/api-reference/api-reference/generation-templates/list-video-templates.md)
- API Reference > Generation Templates [Get a video template](https://docs.empiriolabs.ai/api-reference/api-reference/generation-templates/get-video-template.md)
- API Reference > Generation Templates [List image templates](https://docs.empiriolabs.ai/api-reference/api-reference/generation-templates/list-image-templates.md)
- API Reference > Generation Templates [Get an image template](https://docs.empiriolabs.ai/api-reference/api-reference/generation-templates/get-image-template.md)
- API Reference > Generation Templates [List Compose recipes](https://docs.empiriolabs.ai/api-reference/api-reference/generation-templates/list-compose-recipes.md)
- API Reference > Generation Templates [Create a Compose job](https://docs.empiriolabs.ai/api-reference/api-reference/generation-templates/create-compose-video.md)
- API Reference > Videos [Generate a video](https://docs.empiriolabs.ai/api-reference/api-reference/videos/create-video.md)
- API Reference > 3D Generation [Generate a 3D asset](https://docs.empiriolabs.ai/api-reference/api-reference/3-d-generation/3d/generations.md)
- API Reference > Audio [Generate speech](https://docs.empiriolabs.ai/api-reference/api-reference/audio/create-speech.md)
- API Reference > Audio [Stream speech (real-time TTS)](https://docs.empiriolabs.ai/api-reference/api-reference/audio/create-speech-stream.md)
- API Reference > Audio [Generate music or podcast](https://docs.empiriolabs.ai/api-reference/api-reference/audio/create-audio-generation.md)
- API Reference > Audio [Create a realtime client secret](https://docs.empiriolabs.ai/api-reference/api-reference/audio/create-realtime-client-secret.md)
- API Reference > Audio [List and manage voices](https://docs.empiriolabs.ai/api-reference/api-reference/audio/list-voices.md)
- API Reference > Transcription [Transcribe audio](https://docs.empiriolabs.ai/api-reference/api-reference/transcription/create-transcription.md)
- API Reference > Search [Search and research](https://docs.empiriolabs.ai/api-reference/api-reference/search/create-search.md)
- API Reference > Search [Generate a research report](https://docs.empiriolabs.ai/api-reference/api-reference/search/create-research.md)
- API Reference > Search [Answer a question](https://docs.empiriolabs.ai/api-reference/api-reference/search/create-answer.md)
- API Reference > Agent Tasks [Start an agent task](https://docs.empiriolabs.ai/api-reference/api-reference/agent-tasks/run-agent.md)
- API Reference > Agent Tasks [Retrieve an agent task](https://docs.empiriolabs.ai/api-reference/api-reference/agent-tasks/get-agent-task.md)
- API Reference > Agent Tasks [List agent task messages](https://docs.empiriolabs.ai/api-reference/api-reference/agent-tasks/list-agent-messages.md)
- API Reference > Agent Tasks [Stop an agent task](https://docs.empiriolabs.ai/api-reference/api-reference/agent-tasks/stop-agent-task.md)
- API Reference > Detection [Classify or detect text](https://docs.empiriolabs.ai/api-reference/api-reference/detection/create-detection.md)
- API Reference > GPU Cloud [List volumes](https://docs.empiriolabs.ai/api-reference/api-reference/gpu-cloud/list-gpu-volumes.md)
- API Reference > GPU Cloud [Create a volume](https://docs.empiriolabs.ai/api-reference/api-reference/gpu-cloud/create-gpu-volume.md)
- API Reference > GPU Cloud [Get a volume](https://docs.empiriolabs.ai/api-reference/api-reference/gpu-cloud/get-gpu-volume.md)
- API Reference > GPU Cloud [Delete a volume](https://docs.empiriolabs.ai/api-reference/api-reference/gpu-cloud/delete-gpu-volume.md)
- API Reference > GPU Cloud [List GPU types](https://docs.empiriolabs.ai/api-reference/api-reference/gpu-cloud/list-gpu-types.md)
- API Reference > GPU Cloud [Get a GPU type](https://docs.empiriolabs.ai/api-reference/api-reference/gpu-cloud/get-gpu-type.md)
- API Reference > GPU Cloud [List GPU instances](https://docs.empiriolabs.ai/api-reference/api-reference/gpu-cloud/list-gpu-instances.md)
- API Reference > GPU Cloud [Deploy a GPU](https://docs.empiriolabs.ai/api-reference/api-reference/gpu-cloud/deploy-gpu-instance.md)
- API Reference > GPU Cloud [Get a GPU instance](https://docs.empiriolabs.ai/api-reference/api-reference/gpu-cloud/get-gpu-instance.md)
- API Reference > GPU Cloud [Destroy a GPU instance](https://docs.empiriolabs.ai/api-reference/api-reference/gpu-cloud/destroy-gpu-instance.md)
- API Reference > GPU Cloud [Stop, start, or refresh a GPU instance](https://docs.empiriolabs.ai/api-reference/api-reference/gpu-cloud/action-gpu-instance.md)
- API Reference > GPU Cloud [Run a command](https://docs.empiriolabs.ai/api-reference/api-reference/gpu-cloud/run-gpu-command.md)
- API Reference > GPU Cloud [Connect with SSH](https://docs.empiriolabs.ai/api-reference/api-reference/gpu-cloud/prepare-gpu-ssh.md)
- API Reference > GPU Cloud [List SSH keys](https://docs.empiriolabs.ai/api-reference/api-reference/gpu-cloud/list-gpu-ssh-keys.md)
- API Reference > GPU Cloud [Add an SSH key](https://docs.empiriolabs.ai/api-reference/api-reference/gpu-cloud/create-gpu-ssh-key.md)
- API Reference > GPU Cloud [Delete an SSH key](https://docs.empiriolabs.ai/api-reference/api-reference/gpu-cloud/delete-gpu-ssh-key.md)
- API Reference > GPU Cloud [Connect to a GPU instance](https://docs.empiriolabs.ai/api-reference/api-reference/gpu-cloud/connect-gpu-instance.md)
- API Reference > GPU Cloud [List clusters](https://docs.empiriolabs.ai/api-reference/api-reference/gpu-cloud/list-gpu-clusters.md)
- API Reference > GPU Cloud [Order a cluster](https://docs.empiriolabs.ai/api-reference/api-reference/gpu-cloud/deploy-gpu-cluster.md)
- API Reference > GPU Cloud [Connect to a GPU instance root](https://docs.empiriolabs.ai/api-reference/api-reference/gpu-cloud/connect-gpu-instance-root.md)
- API Reference > GPU Cloud [Send a POST to a GPU instance root](https://docs.empiriolabs.ai/api-reference/api-reference/gpu-cloud/connect-gpu-instance-root-post.md)
- API Reference > GPU Cloud [Send a PUT to a GPU instance root](https://docs.empiriolabs.ai/api-reference/api-reference/gpu-cloud/connect-gpu-instance-root-put.md)
- API Reference > GPU Cloud [Send a PATCH to a GPU instance root](https://docs.empiriolabs.ai/api-reference/api-reference/gpu-cloud/connect-gpu-instance-root-patch.md)
- API Reference > GPU Cloud [Send a DELETE to a GPU instance root](https://docs.empiriolabs.ai/api-reference/api-reference/gpu-cloud/connect-gpu-instance-root-delete.md)
- API Reference > GPU Cloud [Send a POST to a GPU instance](https://docs.empiriolabs.ai/api-reference/api-reference/gpu-cloud/connect-gpu-instance-post.md)
- API Reference > GPU Cloud [Send a PUT to a GPU instance](https://docs.empiriolabs.ai/api-reference/api-reference/gpu-cloud/connect-gpu-instance-put.md)
- API Reference > GPU Cloud [Send a PATCH to a GPU instance](https://docs.empiriolabs.ai/api-reference/api-reference/gpu-cloud/connect-gpu-instance-patch.md)
- API Reference > GPU Cloud [Send a DELETE to a GPU instance](https://docs.empiriolabs.ai/api-reference/api-reference/gpu-cloud/connect-gpu-instance-delete.md)
- API Reference > Hosted Agents [Hosted agent service health](https://docs.empiriolabs.ai/api-reference/api-reference/hosted-agents/health.md)
- API Reference > Hosted Agents [Get hosted agent config](https://docs.empiriolabs.ai/api-reference/api-reference/hosted-agents/get-hosted-agents-config.md)
- API Reference > Hosted Agents [List hosted agents](https://docs.empiriolabs.ai/api-reference/api-reference/hosted-agents/list-hosted-agent-instances.md)
- API Reference > Hosted Agents [Deploy a hosted agent](https://docs.empiriolabs.ai/api-reference/api-reference/hosted-agents/create-hosted-agent-instance.md)
- API Reference > Hosted Agents [Get a hosted agent](https://docs.empiriolabs.ai/api-reference/api-reference/hosted-agents/get-hosted-agent-instance.md)
- API Reference > Hosted Agents [Rename a hosted agent](https://docs.empiriolabs.ai/api-reference/api-reference/hosted-agents/rename-hosted-agent-instance.md)
- API Reference > Hosted Agents [Destroy a hosted agent](https://docs.empiriolabs.ai/api-reference/api-reference/hosted-agents/destroy-hosted-agent-instance.md)
- API Reference > Hosted Agents [Start, stop, or restart a hosted agent](https://docs.empiriolabs.ai/api-reference/api-reference/hosted-agents/action-hosted-agent-instance.md)
- API Reference > Hosted Agents [Message a hosted agent](https://docs.empiriolabs.ai/api-reference/api-reference/hosted-agents/message-hosted-agent-instance.md)
- API Reference > Hosted Agents [Change a hosted agent's model](https://docs.empiriolabs.ai/api-reference/api-reference/hosted-agents/set-hosted-agent-model.md)
- API Reference > Hosted Agents [Set who can message a hosted agent](https://docs.empiriolabs.ai/api-reference/api-reference/hosted-agents/set-hosted-agent-access.md)
- API Reference > Hosted Agents [List hosted agent skills](https://docs.empiriolabs.ai/api-reference/api-reference/hosted-agents/list-hosted-agent-skills.md)
- API Reference > Hosted Agents [Add a hosted agent skill](https://docs.empiriolabs.ai/api-reference/api-reference/hosted-agents/add-hosted-agent-skill.md)
- API Reference > Hosted Agents [Remove a hosted agent skill](https://docs.empiriolabs.ai/api-reference/api-reference/hosted-agents/remove-hosted-agent-skill.md)
- API Reference > Hosted Agents [List hosted agent connectors](https://docs.empiriolabs.ai/api-reference/api-reference/hosted-agents/list-hosted-agent-mcp.md)
- API Reference > Hosted Agents [Attach a hosted agent connector](https://docs.empiriolabs.ai/api-reference/api-reference/hosted-agents/add-hosted-agent-mcp.md)
- API Reference > Hosted Agents [Remove a hosted agent connector](https://docs.empiriolabs.ai/api-reference/api-reference/hosted-agents/remove-hosted-agent-mcp.md)
- API Reference > Hosted Agents [List hosted agent integrations](https://docs.empiriolabs.ai/api-reference/api-reference/hosted-agents/list-hosted-agent-integrations.md)
- API Reference > Hosted Agents [Connect a hosted agent integration](https://docs.empiriolabs.ai/api-reference/api-reference/hosted-agents/save-hosted-agent-integration.md)
- API Reference > Hosted Agents [Disconnect a hosted agent integration](https://docs.empiriolabs.ai/api-reference/api-reference/hosted-agents/disconnect-hosted-agent-integration.md)
- API Reference > Hosted Agents [Set messaging channel behavior](https://docs.empiriolabs.ai/api-reference/api-reference/hosted-agents/set-hosted-agent-integration-behavior.md)
- API Reference > Hosted Agents [Get a hosted agent's activity stats](https://docs.empiriolabs.ai/api-reference/api-reference/hosted-agents/get-hosted-agent-stats.md)
- API Reference > Account [Retrieve account usage](https://docs.empiriolabs.ai/api-reference/api-reference/account/retrieve-account-usage.md)
- API Reference > Playground [List saved conversations](https://docs.empiriolabs.ai/api-reference/api-reference/playground/list-playground-conversations.md)
- API Reference > Playground [Retrieve a saved conversation](https://docs.empiriolabs.ai/api-reference/api-reference/playground/retrieve-playground-conversation.md)
- API Reference > Jobs [List recent jobs](https://docs.empiriolabs.ai/api-reference/api-reference/jobs/list-jobs.md)
- API Reference > Jobs [Retrieve a job](https://docs.empiriolabs.ai/api-reference/api-reference/jobs/retrieve-job.md)
- API Reference > Jobs [Cancel a job](https://docs.empiriolabs.ai/api-reference/api-reference/jobs/cancel-job.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.empiriolabs.ai/api-reference/openapi.json)
- [OpenAPI YAML](https://docs.empiriolabs.ai/api-reference/openapi.yaml)