# ShuYou Docs

> ShuYou AI API Docs

## Docs

- [Get Credits](https://docs.shuyou.ai/en/api-reference/account-management/get-credits.md): Query account credit balance via GET /v1/credits.
- [Gemini 3.1 Flash TTS Preview](https://docs.shuyou.ai/en/api-reference/audio-series/google/gemini-3.1-flash-tts-preview-generate.md): Create asynchronous text-to-speech tasks with gemini-3.1-flash-tts-preview via POST /v1/predictions (function audio).
- [Inworld TTS 1.5 Max](https://docs.shuyou.ai/en/api-reference/audio-series/inworld/inworld-tts-1.5-max-generate.md): Create asynchronous text-to-speech tasks with inworld-tts-1.5-max via POST /v1/predictions (function audio).
- [Inworld TTS 1.5 Mini](https://docs.shuyou.ai/en/api-reference/audio-series/inworld/inworld-tts-1.5-mini-generate.md): Create asynchronous text-to-speech tasks with inworld-tts-1.5-mini via POST /v1/predictions (function audio).
- [MiniMax Speech 2.8 HD](https://docs.shuyou.ai/en/api-reference/audio-series/minimax/speech-2.8-hd-generate.md): Create asynchronous text-to-speech tasks with speech-2.8-hd via POST /v1/predictions (function audio).
- [Qwen3 TTS Flash](https://docs.shuyou.ai/en/api-reference/audio-series/qwen/qwen3-tts-flash-generate.md): Create asynchronous text-to-speech tasks with qwen3-tts-flash via POST /v1/predictions (function audio).
- [Delete File](https://docs.shuyou.ai/en/api-reference/file-series/delete-file.md): Delete an uploaded file by file ID.
- [List Files](https://docs.shuyou.ai/en/api-reference/file-series/list-files.md): List uploaded files in your ShuYou account.
- [Files API Overview](https://docs.shuyou.ai/en/api-reference/file-series/overview.md): Upload and manage files for multimodal Chat Completions and Responses API calls.
- [Upload File](https://docs.shuyou.ai/en/api-reference/file-series/upload-stream.md): Upload a file via multipart/form-data using the OpenAI-compatible Files API.
- [Gemini 2.5 Flash Image (Nano Banana)](https://docs.shuyou.ai/en/api-reference/image-series/gemini/gemini-2.5-flash-image-generate.md): Create asynchronous image tasks with gemini-2.5-flash-image (alias Nano Banana) via POST /v1/predictions (function image).
- [Gemini 3 Pro Image Preview (Nano Banana Pro)](https://docs.shuyou.ai/en/api-reference/image-series/gemini/gemini-3-pro-image-preview-generate.md): Create asynchronous image tasks with gemini-3-pro-image-preview (alias Nano Banana Pro) via POST /v1/predictions (function image).
- [Gemini 3.1 Flash Image Preview (Nano Banana 2)](https://docs.shuyou.ai/en/api-reference/image-series/gemini/gemini-3.1-flash-image-preview-generate.md): Create asynchronous image tasks with gemini-3.1-flash-image-preview (alias Nano Banana 2) via POST /v1/predictions (function image).
- [GPT Image 2 Generation](https://docs.shuyou.ai/en/api-reference/image-series/openai/gpt-image-2-generate.md): Create asynchronous image generation tasks with gpt-image-2 via POST /v1/predictions (function image).
- [Create a Message](https://docs.shuyou.ai/en/api-reference/language-series/anthropic/create-messages.md): Create a message using the Anthropic-compatible Messages API.
- [Create Chat Completion](https://docs.shuyou.ai/en/api-reference/language-series/openai/create-chat-completion.md): Create a chat completion using the OpenAI-compatible Chat Completions API.
- [List Models](https://docs.shuyou.ai/en/api-reference/language-series/openai/openai-list-models.md): List OpenAI-compatible models available on ShuYou.
- [Create a Response](https://docs.shuyou.ai/en/api-reference/language-series/openai/openai-responses.md): Create a model response using the OpenAI-compatible Responses API.
- [Generate Content](https://docs.shuyou.ai/en/api-reference/language-series/vertexai/generate-content.md): Generate content with Google Vertex AI compatible generateContent API.
- [Create Prediction](https://docs.shuyou.ai/en/api-reference/task-management/create-prediction.md): Submit asynchronous image, video, or audio prediction tasks via POST /v1/predictions.
- [Get Generation](https://docs.shuyou.ai/en/api-reference/task-management/get-generation.md): Query generation usage and billing metadata by generation ID.
- [Get Prediction](https://docs.shuyou.ai/en/api-reference/task-management/get-prediction.md): Poll an asynchronous prediction task by task_id via GET /v1/predictions/{prediction_id}.
- [Veo 3.1 Fast Generate Preview](https://docs.shuyou.ai/en/api-reference/video-series/google/veo-3.1-fast-generate-preview-generate.md): Create asynchronous video tasks with veo-3.1-fast-generate-preview via POST /v1/predictions (function video).
- [Veo 3.1 Generate Preview](https://docs.shuyou.ai/en/api-reference/video-series/google/veo-3.1-generate-preview-generate.md): Create asynchronous video tasks with veo-3.1-generate-preview via POST /v1/predictions (function video).
- [Veo 3.1 Lite Generate Preview](https://docs.shuyou.ai/en/api-reference/video-series/google/veo-3.1-lite-generate-preview-generate.md): Create asynchronous video tasks with veo-3.1-lite-generate-preview via POST /v1/predictions (function video).
- [HappyHorse 1.0 I2V](https://docs.shuyou.ai/en/api-reference/video-series/happyhorse/happyhorse-1.0-i2v-video-generate.md): Create asynchronous image-to-video tasks with happyhorse-1.0-i2v via POST /v1/predictions (function video).
- [HappyHorse 1.0 R2V](https://docs.shuyou.ai/en/api-reference/video-series/happyhorse/happyhorse-1.0-r2v-video-generate.md): Create asynchronous reference-to-video tasks with happyhorse-1.0-r2v via POST /v1/predictions (function video).
- [HappyHorse 1.0 T2V](https://docs.shuyou.ai/en/api-reference/video-series/happyhorse/happyhorse-1.0-t2v-video-generate.md): Create asynchronous text-to-video tasks with happyhorse-1.0-t2v via POST /v1/predictions (function video).
- [HappyHorse 1.0 Video Edit](https://docs.shuyou.ai/en/api-reference/video-series/happyhorse/happyhorse-1.0-video-edit-video-generate.md): Create asynchronous video edit tasks with happyhorse-1.0-video-edit via POST /v1/predictions (function video).
- [Kling V3 Video](https://docs.shuyou.ai/en/api-reference/video-series/kling/kling-v3-video-generate.md): Create asynchronous video tasks with kling-v3-video via POST /v1/predictions (function video).
- [OpenAI Sora 2 Pro](https://docs.shuyou.ai/en/api-reference/video-series/openai/sora-2-pro-video-generate.md): Create asynchronous video tasks with sora-2-pro via POST /v1/predictions (function video).
- [OpenAI Sora 2](https://docs.shuyou.ai/en/api-reference/video-series/openai/sora-2-video-generate.md): Create asynchronous video tasks with sora-2 via POST /v1/predictions (function video).
- [Runway Gen-4.5](https://docs.shuyou.ai/en/api-reference/video-series/runway/gen4.5-video-generate.md): Create asynchronous video tasks with gen4.5 via POST /v1/predictions (function video).
- [Doubao Seedance 2.0 Fast](https://docs.shuyou.ai/en/api-reference/video-series/seedance/doubao-seedance-2.0-fast-video-generate.md): Create asynchronous video tasks with doubao-seedance-2.0-fast via POST /v1/predictions (function video).
- [Doubao Seedance 2.0](https://docs.shuyou.ai/en/api-reference/video-series/seedance/doubao-seedance-2.0-video-generate.md): Create asynchronous video tasks with doubao-seedance-2.0 via POST /v1/predictions (function video).
- [Grok Imagine Video](https://docs.shuyou.ai/en/api-reference/video-series/x-ai/grok-imagine-video-generate.md): Create asynchronous video tasks with grok-imagine-video via POST /v1/predictions (function video).
- [Introduction](https://docs.shuyou.ai/en/guide/about/about-us.md): Learn about ShuYou — an enterprise-grade LLM aggregation platform built for developers.
- [Error codes](https://docs.shuyou.ai/en/guide/advanced/error-codes.md)
- [Fallback](https://docs.shuyou.ai/en/guide/advanced/fallback.md)
- [Image generation](https://docs.shuyou.ai/en/guide/advanced/image-generation.md)
- [Long context](https://docs.shuyou.ai/en/guide/advanced/long-context.md)
- [Model routing](https://docs.shuyou.ai/en/guide/advanced/model-routing.md)
- [Multimodal](https://docs.shuyou.ai/en/guide/advanced/multimodal.md)
- [Prompt cache](https://docs.shuyou.ai/en/guide/advanced/prompt-cache.md)
- [Provider routing](https://docs.shuyou.ai/en/guide/advanced/provider-routing.md)
- [Reasoning](https://docs.shuyou.ai/en/guide/advanced/reasoning.md)
- [Streaming](https://docs.shuyou.ai/en/guide/advanced/streaming.md)
- [Structured output](https://docs.shuyou.ai/en/guide/advanced/structured-output.md)
- [Tool Calling](https://docs.shuyou.ai/en/guide/advanced/tool-calls.md)
- [Video generation](https://docs.shuyou.ai/en/guide/advanced/video-generation.md)
- [Web search](https://docs.shuyou.ai/en/guide/advanced/web-search.md)
- [Cherry Studio](https://docs.shuyou.ai/en/guide/integration/cherry-studio.md): Connect Cherry Studio to ShuYou via the OpenAI-compatible API.
- [Claude Code](https://docs.shuyou.ai/en/guide/integration/claude-code.md): Connect Claude Code to ShuYou via the Anthropic-compatible API.
- [CodeBuddy / WorkBuddy](https://docs.shuyou.ai/en/guide/integration/codebuddy-workbuddy.md): Connect CodeBuddy and WorkBuddy to ShuYou via models.json and the OpenAI-compatible API.
- [Codex CLI](https://docs.shuyou.ai/en/guide/integration/codex-cli.md): Connect OpenAI Codex CLI to ShuYou via the OpenAI-compatible API.
- [Cursor](https://docs.shuyou.ai/en/guide/integration/cursor.md): Use ShuYou models in Cursor IDE via OpenAI or Anthropic-compatible settings.
- [Gemini CLI](https://docs.shuyou.ai/en/guide/integration/gemini-cli.md): Connect Google Gemini CLI to ShuYou via the Gemini-compatible API.
- [OpenCode](https://docs.shuyou.ai/en/guide/integration/opencode.md): Connect OpenCode to ShuYou for multi-model terminal coding assistance.
- [Cost](https://docs.shuyou.ai/en/guide/observability/cost.md)
- [Insurance](https://docs.shuyou.ai/en/guide/observability/insurance.md)
- [Logs](https://docs.shuyou.ai/en/guide/observability/logs.md)
- [Pricing](https://docs.shuyou.ai/en/guide/observability/pricing.md)
- [Usage](https://docs.shuyou.ai/en/guide/observability/usage.md)

## OpenAPI Specs

- [grok-imagine-video-generate](https://docs.shuyou.ai/zh/api-reference/video-series/x-ai/grok-imagine-video-generate.json)
- [gen4.5-video-generate](https://docs.shuyou.ai/zh/api-reference/video-series/runway/gen4.5-video-generate.json)
- [sora-2-video-generate](https://docs.shuyou.ai/zh/api-reference/video-series/openai/sora-2-video-generate.json)
- [sora-2-pro-video-generate](https://docs.shuyou.ai/zh/api-reference/video-series/openai/sora-2-pro-video-generate.json)
- [kling-v3-video-generate](https://docs.shuyou.ai/zh/api-reference/video-series/kling/kling-v3-video-generate.json)
- [veo-3.1-lite-generate-preview-generate](https://docs.shuyou.ai/zh/api-reference/video-series/google/veo-3.1-lite-generate-preview-generate.json)
- [veo-3.1-generate-preview-generate](https://docs.shuyou.ai/zh/api-reference/video-series/google/veo-3.1-generate-preview-generate.json)
- [veo-3.1-fast-generate-preview-generate](https://docs.shuyou.ai/zh/api-reference/video-series/google/veo-3.1-fast-generate-preview-generate.json)
- [create-prediction](https://docs.shuyou.ai/zh/api-reference/task-management/create-prediction.json)
- [qwen3-tts-flash-generate](https://docs.shuyou.ai/zh/api-reference/audio-series/qwen/qwen3-tts-flash-generate.json)
- [speech-2.8-hd-generate](https://docs.shuyou.ai/zh/api-reference/audio-series/minimax/speech-2.8-hd-generate.json)
- [inworld-tts-1.5-mini-generate](https://docs.shuyou.ai/zh/api-reference/audio-series/inworld/inworld-tts-1.5-mini-generate.json)
- [inworld-tts-1.5-max-generate](https://docs.shuyou.ai/zh/api-reference/audio-series/inworld/inworld-tts-1.5-max-generate.json)
- [gemini-3.1-flash-tts-preview-generate](https://docs.shuyou.ai/zh/api-reference/audio-series/google/gemini-3.1-flash-tts-preview-generate.json)
- [doubao-seedance-2.0-video-generate](https://docs.shuyou.ai/zh/api-reference/video-series/seedance/doubao-seedance-2.0-video-generate.json)
- [doubao-seedance-2.0-fast-video-generate](https://docs.shuyou.ai/zh/api-reference/video-series/seedance/doubao-seedance-2.0-fast-video-generate.json)
- [happyhorse-1.0-video-edit-video-generate](https://docs.shuyou.ai/zh/api-reference/video-series/happyhorse/happyhorse-1.0-video-edit-video-generate.json)
- [happyhorse-1.0-t2v-video-generate](https://docs.shuyou.ai/zh/api-reference/video-series/happyhorse/happyhorse-1.0-t2v-video-generate.json)
- [happyhorse-1.0-r2v-video-generate](https://docs.shuyou.ai/zh/api-reference/video-series/happyhorse/happyhorse-1.0-r2v-video-generate.json)
- [happyhorse-1.0-i2v-video-generate](https://docs.shuyou.ai/zh/api-reference/video-series/happyhorse/happyhorse-1.0-i2v-video-generate.json)
- [get-prediction](https://docs.shuyou.ai/zh/api-reference/task-management/get-prediction.json)
- [get-generation](https://docs.shuyou.ai/zh/api-reference/task-management/get-generation.json)
- [generate-content](https://docs.shuyou.ai/zh/api-reference/language-series/vertexai/generate-content.json)
- [openai-responses](https://docs.shuyou.ai/zh/api-reference/language-series/openai/openai-responses.json)
- [openai-list-models](https://docs.shuyou.ai/zh/api-reference/language-series/openai/openai-list-models.json)
- [create-chat-completion](https://docs.shuyou.ai/zh/api-reference/language-series/openai/create-chat-completion.json)
- [create-messages](https://docs.shuyou.ai/zh/api-reference/language-series/anthropic/create-messages.json)
- [anthropic-list-models](https://docs.shuyou.ai/zh/api-reference/language-series/anthropic/anthropic-list-models.json)
- [gpt-image-2-generate](https://docs.shuyou.ai/zh/api-reference/image-series/openai/gpt-image-2-generate.json)
- [gemini-3.1-flash-image-preview-generate](https://docs.shuyou.ai/zh/api-reference/image-series/gemini/gemini-3.1-flash-image-preview-generate.json)
- [gemini-3-pro-image-preview-generate](https://docs.shuyou.ai/zh/api-reference/image-series/gemini/gemini-3-pro-image-preview-generate.json)
- [gemini-2.5-flash-image-generate](https://docs.shuyou.ai/zh/api-reference/image-series/gemini/gemini-2.5-flash-image-generate.json)
- [upload-stream](https://docs.shuyou.ai/zh/api-reference/file-series/upload-stream.json)
- [list-files](https://docs.shuyou.ai/zh/api-reference/file-series/list-files.json)
- [delete-file](https://docs.shuyou.ai/zh/api-reference/file-series/delete-file.json)
- [get-credits](https://docs.shuyou.ai/zh/api-reference/account-management/get-credits.json)
- [openapi](https://docs.shuyou.ai/openapi.json)