# you-token文档

## Docs
- 引言 [获取令牌](https://doc.you-token.com/8329879m0.md): 
- 引言 [一个完整的请求案例](https://doc.you-token.com/8329880m0.md): 
- 引言 [关于缓存创建与命中](https://doc.you-token.com/8329881m0.md): 
- 引言 [联系客服](https://doc.you-token.com/8329882m0.md): 
- 引言 [定价说明](https://doc.you-token.com/8329883m0.md): 
- 引言 [常见接口错误类型说明](https://doc.you-token.com/8329884m0.md): 
- 模型介绍 [GPT 系列](https://doc.you-token.com/8329885m0.md): 
- 模型介绍 [Claude 系列](https://doc.you-token.com/8329886m0.md): 
- 模型介绍 [Gemini 系列](https://doc.you-token.com/8329887m0.md): 
- 模型介绍 [DeepSeek系列](https://doc.you-token.com/8329888m0.md): 
- 模型介绍 [百度文心一言](https://doc.you-token.com/8329889m0.md): 
- 模型介绍 [阿里通义千问](https://doc.you-token.com/8329890m0.md): 

## API Docs
- 模型接口 > 模型查询相关 [模型列表查询](https://doc.you-token.com/428616981e0.md): 获取当前（令牌）可用的模型列表
- 模型接口 > 模型查询相关 [令牌用量查询](https://doc.you-token.com/428616982e0.md): 通过认证查询当前 Bearer Token 的额度使用情况：授予总量、已用、剩余、是否无限、模型限额及到期时间。
- 模型接口 > 模型查询相关 [获取账号信息](https://doc.you-token.com/428616983e0.md): 
- 模型接口 > 聊天(Chat) > OpenAI > 基础聊天(ChatCompletions格式) [基础文本对话](https://doc.you-token.com/428616984e0.md): 本中转所有模型均已适配v1/chat/completions
- 模型接口 > 聊天(Chat) > OpenAI > 基础聊天(ChatCompletions格式) [流式响应](https://doc.you-token.com/428616985e0.md): 本中转所有模型均已适配v1/chat/completions
- 模型接口 > 聊天(Chat) > OpenAI > 基础聊天(ChatCompletions格式) [内容补全(早期接口)](https://doc.you-token.com/428616986e0.md): /v1/chat/completions 是为对话优化的现代接口（用 messages 数组管理多轮上下文，适配 GPT-3.5/4/4o 等聊天模型）；
- 模型接口 > 聊天(Chat) > OpenAI > 基础聊天(ChatCompletions格式) [PDF文件分析](https://doc.you-token.com/428616987e0.md): PDF转成base64替换到${base64String}
- 模型接口 > 聊天(Chat) > OpenAI > 基础聊天(ChatCompletions格式) [代码生成(codex)](https://doc.you-token.com/428616988e0.md): 官方文档：https://openai.com/index/introducing-codex/
- 模型接口 > 聊天(Chat) > OpenAI > 基础聊天(ChatCompletions格式) [结构化输出](https://doc.you-token.com/428616989e0.md): 这是 OpenAI 较新的功能（GPT-4o 及以上版本支持），用于强制模型返回结构化的 JSON 数据，解决了大模型自由文本回复格式不统一、难以被程序解析的问题
- 模型接口 > 聊天(Chat) > OpenAI > 基础聊天(ChatCompletions格式) [联网搜索](https://doc.you-token.com/428616990e0.md): Grok-4 是 xAI（马斯克旗下人工智能公司）推出的新一代大语言模型，主打实时联网搜索能力与多源信息整合，是面向实时信息交互场景设计的模型，核心特性如下：
- 模型接口 > 聊天(Chat) > OpenAI > 基础聊天(ChatCompletions格式) [GPTs对话](https://doc.you-token.com/428616991e0.md): 什么是gpts?, 简而言之就是openai开发的插件商店，用户可以自定义自己的gpts，针对各种场景专门使用，例如论文搜索、翻译、代码补全等等，这里只是简单介绍一下如何接入，更多的gpts使用方法请自行搜索
- 模型接口 > 聊天(Chat) > OpenAI > 会话聊天(Responses格式) [基础文本响应](https://doc.you-token.com/428616992e0.md): 
- 模型接口 > 聊天(Chat) > OpenAI > 会话聊天(Responses格式) [图像分析响应](https://doc.you-token.com/428616993e0.md): 
- 模型接口 > 聊天(Chat) > OpenAI > 会话聊天(Responses格式) [网络搜索工具](https://doc.you-token.com/428616994e0.md): 
- 模型接口 > 聊天(Chat) > OpenAI > 会话聊天(Responses格式) [文件搜索工具](https://doc.you-token.com/428616995e0.md): 
- 模型接口 > 聊天(Chat) > OpenAI > 会话聊天(Responses格式) [计算机模拟](https://doc.you-token.com/428616996e0.md): /v1/responses 是 OpenAI 为 computer-use-preview（计算机使用预览版）模型设计的专用接口，区别于常规的 /v1/chat/completions（纯文本对话），专门用于：
- 模型接口 > 聊天(Chat) > OpenAI > 会话聊天(Responses格式) [深度研究](https://doc.you-token.com/428616997e0.md): 
- 模型接口 > 聊天(Chat) > OpenAI > 会话聊天(Responses格式) [函数调用](https://doc.you-token.com/428616998e0.md): 
- 模型接口 > 聊天(Chat) > OpenAI > 会话聊天(Responses格式) [推理能力](https://doc.you-token.com/428616999e0.md): 
- 模型接口 > 聊天(Chat) > Google Gemini [文本聊天](https://doc.you-token.com/428617000e0.md): 
- 模型接口 > 聊天(Chat) > Google Gemini [媒体识别](https://doc.you-token.com/428617001e0.md): 
- 模型接口 > 聊天(Chat) > Google Gemini [视频理解](https://doc.you-token.com/428617002e0.md): Gemini 视频理解接口（原生格式）。
- 模型接口 > 聊天(Chat) > Anthropic Claude [文本生成](https://doc.you-token.com/428617003e0.md): 
- 模型接口 > 聊天(Chat) > Anthropic Claude [图片理解](https://doc.you-token.com/428617004e0.md): 支持官方原生格式，模型名称和官方一致
- 模型接口 > 聊天(Chat) > Anthropic Claude [深度思考](https://doc.you-token.com/428617005e0.md): Claude原生格式请求，强制思考请使用模型后缀-thinking，如claude-sonnet-4-20250514-thinking
- 模型接口 > 聊天(Chat) > Anthropic Claude [函数调用](https://doc.you-token.com/428617006e0.md): 支持官方原生格式，模型名称和官方一致
- 模型接口 > 聊天(Chat) > Anthropic Claude [联网搜索](https://doc.you-token.com/428617007e0.md): 
- 模型接口 > 聊天(Chat) > Anthropic Claude [带缓存创建的文本对话](https://doc.you-token.com/428617008e0.md): ## 以模型：claude-opus-4-6 为例
- 模型接口 > 图像(Images) > Midjourney [文生图（Imagine）接口](https://doc.you-token.com/428617009e0.md): 执行Imagine操作，提交绘图任务。提交任务后，获取到任务id，使用查询接口查询任务状态。
- 模型接口 > 图像(Images) > Midjourney [按钮点击（Action）接口](https://doc.you-token.com/428617010e0.md): 该接口是用于点击图片下方的按钮，customId通过任务查询接口可以获取到。
- 模型接口 > 图像(Images) > Midjourney [图片融合（Blend）接口](https://doc.you-token.com/428617011e0.md): 执行Blend操作，提交融图任务。
- 模型接口 > 图像(Images) > Midjourney [窗口执行（Modal）接口](https://doc.you-token.com/428617012e0.md): 当执行其他任务，code返回21时，需要执行modal接口，传入新的提示词用来修改细节。
- 模型接口 > 图像(Images) > Midjourney [图生文（Describe）接口](https://doc.you-token.com/428617013e0.md): 执行Describe操作，提交图生文任务。
- 模型接口 > 图像(Images) > Midjourney [缩短提示词（Shorten）接口](https://doc.you-token.com/428617014e0.md): 执行shorten操作，识别在关键词中有哪些单词在生成图像时发挥关键因素，哪些单词则不太重要。
- 模型接口 > 图像(Images) > Midjourney [换脸（FaceSwap）接口](https://doc.you-token.com/428617015e0.md): 提交FaceSwap任务，进行换脸操作。
- 模型接口 > 图像(Images) > Midjourney [上传（upload）接口](https://doc.you-token.com/428617016e0.md): 执行Imagine操作，提交绘图任务。提交任务后，获取到任务id，使用查询接口查询任务状态。
- 模型接口 > 图像(Images) > Midjourney [查询接口](https://doc.you-token.com/428617017e0.md): 通过任务id，查询任务信息。（可以通过轮询调用该接口，实现任务进行的查询。也可以通过回调接口获取）
- 模型接口 > 图像(Images) > Midjourney [批量查询接口](https://doc.you-token.com/428617018e0.md): 通过任务id数组，查询任务信息。（可以通过轮询调用该接口，实现任务进行的查询。也可以通过回调接口获取）
- 模型接口 > 图像(Images) > Midjourney [获取种子（Seed）接口](https://doc.you-token.com/428617019e0.md): 通过任务id，查询任务信息。（可以通过轮询调用该接口，实现任务进行的查询。也可以通过回调接口获取）
- 模型接口 > 图像(Images) > Midjourney [编辑图片（Edit）接口](https://doc.you-token.com/428617020e0.md): 执行edit接口，可以编辑外部传入的图片，可以进行局部重绘，也可以直接改图
- 模型接口 > 图像(Images) > Midjourney [生成视频（Video）接口](https://doc.you-token.com/428617021e0.md): 执行video操作，提交绘图任务。提交任务后，获取到任务id，使用查询接口查询任务状态。（视频的按钮可以使用action进行点击）
- 模型接口 > 图像(Images) > OpenAI [图片生成 / gpt-image-1.5](https://doc.you-token.com/428617022e0.md): 根据提示词以及其他参数创建图片
- 模型接口 > 图像(Images) > OpenAI [图片生成 / dall-e-3](https://doc.you-token.com/428617023e0.md): 根据提示词以及其他参数创建图片
- 模型接口 > 图像(Images) > OpenAI [图片编辑 / edits接口](https://doc.you-token.com/428617024e0.md): 根据一个或多个原始图片和提示创建编辑或扩展的图片。此端点支持 dall-e-2 和 gpt-image-1 模型。
- 模型接口 > 图像(Images) > OpenAI [图片变体生成](https://doc.you-token.com/428617025e0.md): 创建给定图片的变体。
- 模型接口 > 图像(Images) > OpenAI [gpt-4-all（生成图片）](https://doc.you-token.com/428617026e0.md): 根据提示词以及其他参数创建图片
- 模型接口 > 图像(Images) > Google Gemini > OpenAI聊天格式 [图片生成（Nano-banana2）](https://doc.you-token.com/428617027e0.md): Gemini 也提供了图像生成能力，作为一种替代方案。与 Imagen 3.0 相比，Gemini 的图像生成更适合于需要上下文理解和推理的场景，而非追求极致的艺术表现和视觉质量。
- 模型接口 > 图像(Images) > Google Gemini > OpenAI聊天格式 [图片生成 / Imagen 4](https://doc.you-token.com/428617028e0.md): Gemini 绘图和视频生成指引
- 模型接口 > 图像(Images) > Google Gemini > Gemini原生格式 [图像生成](https://doc.you-token.com/428617029e0.md): 
- 模型接口 > 图像(Images) > 豆包(Doubao) [文生图(纯文本输入单图输出)](https://doc.you-token.com/428617030e0.md): 通过文字描述来生成对应图像。
- 模型接口 > 图像(Images) > 豆包(Doubao) [图文生图(单图输入单图输出)](https://doc.you-token.com/428617031e0.md): 基于已有图片，结合文字指令进行图像编辑，包括图像元素增删、风格转化、材质替换、色调迁移、改变背景/视角/尺寸等。
- 模型接口 > 图像(Images) > 豆包(Doubao) [多图融合(多图输入单图输出)](https://doc.you-token.com/428617032e0.md): 根据您输入的文本描述和多张参考图片，融合它们的风格、元素等特征来生成新图像。如衣裤鞋帽与模特图融合成穿搭图，人物与风景融合为人物风景图等。
- 模型接口 > 图像(Images) > 豆包(Doubao) [组图输出(多图输出)](https://doc.you-token.com/428617033e0.md): 支持通过一张或者多张图片和文字信息，生成漫画分镜、品牌视觉等一组内容关联的图片。
- 模型接口 > 图像(Images) > 阿里通义千问 [文生图-Z-Image](https://doc.you-token.com/428617034e0.md): 官方文档：https://help.aliyun.com/zh/model-studio/z-image-api-reference?spm=a2c4g.11186623.help-menu-2400256.d_2_2_3.5183699dL6MJpu&scm=20140722.H_3002354._.OR_help-T_cn~zh-V_1
- 模型接口 > 图像(Images) > 阿里通义千问 [文生图](https://doc.you-token.com/428617035e0.md): 官方文档：https://help.aliyun.com/zh/model-studio/z-image-api-reference?spm=a2c4g.11186623.help-menu-2400256.d_2_2_3.5183699dL6MJpu&scm=20140722.H_3002354._.OR_help-T_cn~zh-V_1
- 模型接口 > 图像(Images) > 阿里通义千问 [文生图V2版](https://doc.you-token.com/428617036e0.md): 官方文档：https://help.aliyun.com/zh/model-studio/z-image-api-reference?spm=a2c4g.11186623.help-menu-2400256.d_2_2_3.5183699dL6MJpu&scm=20140722.H_3002354._.OR_help-T_cn~zh-V_1
- 模型接口 > 图像(Images) > 阿里通义千问 [文生图V1版](https://doc.you-token.com/428617037e0.md): 官方文档：https://help.aliyun.com/zh/model-studio/z-image-api-reference?spm=a2c4g.11186623.help-menu-2400256.d_2_2_3.5183699dL6MJpu&scm=20140722.H_3002354._.OR_help-T_cn~zh-V_1
- 模型接口 > 视频(Videos) > OpenAI兼容接口 [Veo 视频生成（OpenAI 兼容格式）](https://doc.you-token.com/428617038e0.md): Google Veo 视频生成接口（OpenAI 兼容格式）。
- 模型接口 > 视频(Videos) > OpenAI兼容接口 [查询视频生成状态 Copy](https://doc.you-token.com/428617039e0.md): 查询视频生成任务的状态和结果。
- 模型接口 > 视频(Videos) > OpenAI兼容接口 [luma](https://doc.you-token.com/428617040e0.md): 文生视频模型，已统一接口，可直接chat格式调用：luma-vip-video（VIP版，极速、免排队、无水印）、pika-text-to-video
- 模型接口 > 视频(Videos) > OpenAI兼容接口 [runway](https://doc.you-token.com/428617041e0.md): 文生视频模型，已统一接口，可直接chat格式调用：runway-video、runway-vip-video（更快无水印）
- 模型接口 > 视频(Videos) > Veo 3 [Veo 视频生成](https://doc.you-token.com/428617042e0.md): Google Veo 视频生成接口（官方格式）。
- 模型接口 > 视频(Videos) > Veo 3 [查询视频生成状态](https://doc.you-token.com/428617043e0.md): 查询 Veo 视频生成任务的状态和结果。
- 模型接口 > 视频(Videos) > Sora-2 [Sora-2（创建视频）](https://doc.you-token.com/428617044e0.md): v1/videos 接口核心必选参数为 model/prompt/duration/resolution，其余为可选增强配置；
- 模型接口 > 视频(Videos) > Sora-2 [Sora2官方接口（Chat格式）](https://doc.you-token.com/428617045e0.md): 本中转所有模型均已适配v1/chat/completions
- 模型接口 > 视频(Videos) > Sora-2 [查询视频（异步任务）](https://doc.you-token.com/428617046e0.md): 
- 模型接口 > 视频(Videos) > Sora-2 [获取视频内容](https://doc.you-token.com/428617047e0.md): 获取已完成视频任务的视频文件内容。
- 模型接口 > 视频(Videos) > 阿里通义千问 [通义万相2.6（创建视频）](https://doc.you-token.com/428617048e0.md): 
- 模型接口 > 视频(Videos) > 阿里通义千问 [查询视频（异步任务）](https://doc.you-token.com/428617049e0.md): 
- 模型接口 > 视频(Videos) > 豆包(Doubao) [豆包-文生视频](https://doc.you-token.com/428617050e0.md): API文档：https://www.volcengine.com/docs/85621/1538636
- 模型接口 > 视频(Videos) > 豆包(Doubao) [查询视频](https://doc.you-token.com/428617051e0.md): 
- 模型接口 > 视频(Videos) > 可灵AI(Kling) [可灵AI-文生视频](https://doc.you-token.com/428617052e0.md): 使用 Kling 模型从文本描述生成视频。
- 模型接口 > 视频(Videos) > 可灵AI(Kling) [可灵AI-文生视频kling-video-o1](https://doc.you-token.com/428617053e0.md): 使用 Kling 模型从文本描述生成视频。
- 模型接口 > 视频(Videos) > 可灵AI(Kling) [可灵AI-图生视频](https://doc.you-token.com/428617054e0.md): 使用 Kling 模型从图片生成视频。
- 模型接口 > 视频(Videos) > 即梦(Jimeng) [即梦AI-文生视频S2.0Pro](https://doc.you-token.com/428617055e0.md): API文档：https://www.volcengine.com/docs/85621/1538636
- 模型接口 > 音频(Audio) > 原生OpenAI格式 [文本转语音 / TTS](https://doc.you-token.com/428617057e0.md): 了解如何将文本转换为音频。
- 模型接口 > 音频(Audio) > 原生OpenAI格式 [语音转文本 / whisper-1](https://doc.you-token.com/428617058e0.md): 了解如何将音频转换为文本。
- 模型接口 > 音频(Audio) > 原生OpenAI格式 [语音转文本 / gpt-4o-transcribe](https://doc.you-token.com/428617059e0.md): 官方文档：https://platform.openai.com/docs/api-reference/audio/createTranscription
- 模型接口 > 音频(Audio) > 原生OpenAI格式 [音频翻译](https://doc.you-token.com/428617060e0.md): 将音频翻译成英文。
- 模型接口 > 音频(Audio) > 原生OpenAI格式 [Audio接口 / 输出](https://doc.you-token.com/428617061e0.md): 
- 模型接口 > 音频(Audio) > 原生OpenAI格式 [Audio接口 / 输入](https://doc.you-token.com/428617062e0.md): 
- 模型接口 > 音频(Audio) > 原生OpenAI格式 [MiniMax语音合成TTS](https://doc.you-token.com/428617063e0.md): 
- 模型接口 > 音频(Audio) > 原生OpenAI格式 [豆包语音2.0](https://doc.you-token.com/428617064e0.md): 每个音色能支持的情感不同,
- 模型接口 > 音频(Audio) [原生Gemini格式](https://doc.you-token.com/428617056e0.md): Gemini 音频生成接口。
- 模型接口 > 音乐(Music) > Suno [生成歌曲](https://doc.you-token.com/428617065e0.md): Suno v5版本更新公告
- 模型接口 > 音乐(Music) > Suno [生成歌词](https://doc.you-token.com/428617066e0.md): 
- 模型接口 > 音乐(Music) > Suno [上传音乐](https://doc.you-token.com/428617067e0.md): 
- 模型接口 > 音乐(Music) > Suno [歌曲拼接](https://doc.you-token.com/428617068e0.md): 
- 模型接口 > 音乐(Music) > Suno [单个查询任务](https://doc.you-token.com/428617069e0.md): 
- 模型接口 > 音乐(Music) > Suno [批量查询任务](https://doc.you-token.com/428617070e0.md): 
- 模型接口 > 音乐(Music) > Udio [Udio(Chat格式)](https://doc.you-token.com/428617071e0.md): 文生视频模型，已统一接口，可直接chat格式调用：luma-vip-video（VIP版，极速、免排队、无水印）、pika-text-to-video
- 模型接口 > 嵌入(Embeddings) [创建文本嵌入(OpenAI)](https://doc.you-token.com/428617072e0.md): 获取给定输入的矢量表示，机器学习模型和算法可以轻松使用该表示。
- 模型接口 > 嵌入(Embeddings) [批量创建嵌入(OpenAI)](https://doc.you-token.com/428617073e0.md): 获取给定输入的矢量表示，机器学习模型和算法可以轻松使用该表示。
- 模型接口 > 嵌入(Embeddings) [创建文本嵌入(Gemini)](https://doc.you-token.com/428617074e0.md): 
- 模型接口 > 重排序 (Rerank) [Jina AI 重排序格式](https://doc.you-token.com/428617075e0.md): 官方文档：https://jina.ai/reranker
- 模型接口 > 重排序 (Rerank) [Cohere 重排序格式](https://doc.you-token.com/428617076e0.md): 重要提示：cohere 的 Rerank 模型接口和 Jina的Rerank模型接口格式 是一样的。
- 模型接口 > 重排序 (Rerank) [Xinference 重排序格式](https://doc.you-token.com/428617077e0.md): 重要提示：Xinference的rerank响应结构将被格式化为Jina的rerank响应结构，使用方式和Jina的rerank相同。对于Dify等客户端用户：在配置时请选择 Jina AI 作为供应商类型，而不是Xinference，并使用Xinference支持的模型名称。
- 模型接口 > 审查(Moderations) [创建内容审核](https://doc.you-token.com/428617078e0.md): 对文本是否违反 OpenAI 的内容政策进行分类