# jiniu.ai

## Docs
- [平台介绍](https://docs.jiniu.ai/8848743m0.md): 
- [快速接入指南](https://docs.jiniu.ai/8848750m0.md): 
- [Claude Code 配置教程](https://docs.jiniu.ai/8848751m0.md): 
- [Cursor 配置教程](https://docs.jiniu.ai/8848752m0.md): 
- [OpenAI Codex CLI 配置教程](https://docs.jiniu.ai/8848753m0.md): 
- [Gemini CLI 配置教程](https://docs.jiniu.ai/8848754m0.md): 
- [OpenCode 配置教程](https://docs.jiniu.ai/8848755m0.md): 
- [CC Switch 配置教程](https://docs.jiniu.ai/8848756m0.md): 
- [Node.js 安装教程](https://docs.jiniu.ai/8848757m0.md): 
- [Trae IDE 配置教程](https://docs.jiniu.ai/8848758m0.md): 

## API Docs
- 模型管理 [获取可用模型列表](https://docs.jiniu.ai/463244515e0.md): 返回当前令牌可访问的所有模型列表。
- OpenAI 格式接口 [文本对话（OpenAI 格式）](https://docs.jiniu.ai/463244516e0.md): 创建一个对话补全请求，完全兼容 OpenAI Chat Completions API。
- Anthropic Claude 格式接口 [文本对话（Anthropic Claude 格式）](https://docs.jiniu.ai/463244517e0.md): 创建一个 Claude Messages API 请求，完全兼容 Anthropic 原生接口格式。
- Google Gemini 格式接口 [文本对话（Gemini 格式）](https://docs.jiniu.ai/463244518e0.md): 创建一个 Gemini generateContent 请求，完全兼容 Google Gemini API 原生格式。
- Google Gemini 格式接口 [文本对话 - 流式输出（Gemini 格式）](https://docs.jiniu.ai/463244519e0.md): 与 `generateContent` 接口相同，但以流式（SSE）方式返回结果。
- 图像生成接口 [生成图像（文生图）](https://docs.jiniu.ai/463244520e0.md): 根据文本描述生成图像。
- 图像编辑接口 [编辑图像（图生图）](https://docs.jiniu.ai/463244521e0.md): 基于已有图像和文本指令生成编辑后的图像。
- 视频生成(Seedance) > 素材组 [创建素材组](https://docs.jiniu.ai/479851707e0.md): 创建一个素材组（Asset Group），用于归类存放素材。返回素材组 ID，后续创建 / 查询素材时使用。
- 视频生成(Seedance) > 素材组 [查询素材组](https://docs.jiniu.ai/479851708e0.md): 按素材组 ID 查询素材组详情。
- 视频生成(Seedance) > 素材组 [查询素材组列表](https://docs.jiniu.ai/479851709e0.md): **仅返回当前 API Key 所属账号自己创建的素材组**（含真人认证资产组），支持名称模糊搜索与分页。
- 视频生成(Seedance) > 素材组 [删除素材组](https://docs.jiniu.ai/479851710e0.md): 按素材组 ID 删除素材组。
- 视频生成(Seedance) > 素材 [上传素材](https://docs.jiniu.ai/479851711e0.md): 把一个**公网可下载地址**的文件加入素材组。接口**同步完成**「下载源文件 → 转存 → 创建资产」，大文件（尤其视频）可达数分钟，**建议客户端超时 ≥ 600 秒**。
- 视频生成(Seedance) > 素材 [查询素材](https://docs.jiniu.ai/479851712e0.md): 按资产 ID 查询素材详情与状态。引用素材（`asset://`）前建议先确认 `Status=Active`。
- 视频生成(Seedance) > 素材 [查询素材列表](https://docs.jiniu.ai/479851713e0.md): **仅返回当前 API Key 所属账号自己上传的素材**，支持按素材组 / 类型 / 状态过滤与名称模糊搜索、分页。常用于引用素材（`asset://`）前列出可用素材、回查 AssetID。
- 视频生成(Seedance) > 素材 [删除素材](https://docs.jiniu.ai/479851714e0.md): 按资产 ID 删除素材。
- 视频生成(Seedance) > 真人认证 [创建真人认证 H5 会话](https://docs.jiniu.ai/479851715e0.md): 创建**真人资产组**认证会话：返回 H5 认证链接与二维码。用户在手机端完成实名认证后，再用返回的 `BytedToken` 轮询 GetVisualValidateResult 拿资产组 `GroupId`。
- 视频生成(Seedance) > 真人认证 [查询真人认证结果](https://docs.jiniu.ai/479851716e0.md): 用 `BytedToken` 轮询真人认证是否完成。完成后返回真人资产组 `GroupId`，之后可像普通素材组一样使用。
- 视频生成(Seedance) > 真人认证 [创建真人认证 H5 临时链接（平台提供）](https://docs.jiniu.ai/479851717e0.md): **平台高层入口**（火山方舟无此 Action，不转发上游）：一次调用拿到可直接发给终端用户的 H5 页面链接，页面内部自动完成「创建会话 → 展示二维码/认证 → 轮询拿 GroupId」。优点是**全程不暴露 sk-**：链接携带短期、仅能调真人认证的 `rt_` 临时令牌（签发时已绑定上游渠道）。
- 视频生成(Seedance) > 真人认证 [[H5] 创建真人认证会话（rt_ 令牌）](https://docs.jiniu.ai/479851718e0.md): 供真人认证 H5 页面用 `rt_` 临时令牌调用（语义同 `/api/material?Action=CreateVisualValidateSession`，但**无需 sk-**）。中间件按 `rt_` 绑定的渠道注入，仅放行真人认证两个动作。`/api/rv` 已开启 CORS，支持 H5 跨域直连。
- 视频生成(Seedance) > 真人认证 [[H5] 查询真人认证结果（rt_ 令牌）](https://docs.jiniu.ai/479851719e0.md): 供真人认证 H5 页面用 `rt_` 临时令牌轮询认证结果（语义同 `/api/material?Action=GetVisualValidateResult`）。
- 视频生成(Seedance) > 视频生成 · New-API 兼容 [文生视频（New-API 兼容）](https://docs.jiniu.ai/479851945e0.md): 纯文本提示词生成视频。
- 视频生成(Seedance) > 视频生成 · New-API 兼容 [图生视频（New-API 兼容）](https://docs.jiniu.ai/479851946e0.md): 图片 + 文本生成视频。参考图放顶层 `images`（公网 URL）。
- 视频生成(Seedance) > 视频生成 · New-API 兼容 [视频生视频（New-API 兼容）](https://docs.jiniu.ai/479851947e0.md): 参考视频 + 文本生成视频。参考视频放 `metadata.content` 的 `video_url` 条目（顶层无快捷字段）。
- 视频生成(Seedance) > 视频生成 · New-API 兼容 [素材引用生视频（New-API 兼容）](https://docs.jiniu.ai/479851948e0.md): 引用素材库资产（`asset://{AssetID}`）+ 文本生成视频。把 `image_url.url` 设为 `asset://...`、`role=reference_image`，放入 `metadata.content`。AssetID 来自素材库 CreateAsset / ListAssets。
- 视频生成(Seedance) > 视频生成 · New-API 兼容 [查询任务（New-API 兼容）](https://docs.jiniu.ai/479851949e0.md): 轮询任务状态。响应为 New-API 通用任务结构 `{ code, message, data }`；**业务失败看 `data.status`，勿只看 HTTP 码**。轮询建议 10 秒间隔、600s 超时。
- 视频生成(Seedance) > 视频生成 · 原生格式 [文生视频（原生格式）](https://docs.jiniu.ai/479851950e0.md): 纯文本提示词生成视频。
- 视频生成(Seedance) > 视频生成 · 原生格式 [图生视频（原生格式）](https://docs.jiniu.ai/479851951e0.md): 图片 + 文本生成视频。`image_url` 条目**必须带 `role: reference_image`**，否则参数错误。
- 视频生成(Seedance) > 视频生成 · 原生格式 [视频生视频（原生格式）](https://docs.jiniu.ai/479851952e0.md): 参考视频 + 文本生成视频。`video_url` 条目带 `role: reference_video`。
- 视频生成(Seedance) > 视频生成 · 原生格式 [素材引用生视频（原生格式）](https://docs.jiniu.ai/479851953e0.md): 引用素材库资产生成视频。把 `image_url.url` 设为 `asset://{AssetID}`、`role: reference_image`。AssetID 来自素材库 CreateAsset / ListAssets。
- 视频生成(Seedance) > 视频生成 · 原生格式 [查询任务（原生格式）](https://docs.jiniu.ai/479851954e0.md): 轮询任务状态。`status=succeeded` 时返回 `content.video_url` 与 `usage.completion_tokens`。轮询建议 10 秒间隔、600s 超时。

## Schemas
- [OpenAIMessage](https://docs.jiniu.ai/277810389d0.md): 
- [ResponseMetadata](https://docs.jiniu.ai/289420188d0.md): 
- [NativeContentItem](https://docs.jiniu.ai/289420265d0.md): 
- [ChatCompletionRequest](https://docs.jiniu.ai/277810390d0.md): 
- [BusinessError](https://docs.jiniu.ai/289420189d0.md): 
- [VideoMetadata](https://docs.jiniu.ai/289420266d0.md): 
- [ChatCompletionResponse](https://docs.jiniu.ai/277810391d0.md): 
- [NativeCreateRequest](https://docs.jiniu.ai/289420267d0.md): 
- [OpenAIUsage](https://docs.jiniu.ai/277810392d0.md): 
- [IdResult](https://docs.jiniu.ai/289420191d0.md): 
- [NewApiCreateRequest](https://docs.jiniu.ai/289420268d0.md): 
- [ClaudeMessage](https://docs.jiniu.ai/277810393d0.md): 
- [AssetGroup](https://docs.jiniu.ai/289420192d0.md): 
- [NativeCreateResponse](https://docs.jiniu.ai/289420269d0.md): 
- [ClaudeMessagesRequest](https://docs.jiniu.ai/277810394d0.md): 
- [AssetGroupListItem](https://docs.jiniu.ai/289420193d0.md): 
- [NativeQueryResponse](https://docs.jiniu.ai/289420270d0.md): 
- [ClaudeMessagesResponse](https://docs.jiniu.ai/277810395d0.md): 
- [Asset](https://docs.jiniu.ai/289420194d0.md): 
- [NewApiCreateResponse](https://docs.jiniu.ai/289420271d0.md): 
- [GeminiContent](https://docs.jiniu.ai/277810396d0.md): 
- [AssetListItem](https://docs.jiniu.ai/289420195d0.md): 
- [NewApiQueryResponse](https://docs.jiniu.ai/289420272d0.md): 
- [GeminiGenerateContentRequest](https://docs.jiniu.ai/277810397d0.md): 
- [GatewayError](https://docs.jiniu.ai/289420190d0.md): 
- [GeminiGenerateContentResponse](https://docs.jiniu.ai/277810398d0.md): 
- [ImageGenerationRequest](https://docs.jiniu.ai/277810399d0.md): 
- [ImageEditRequest](https://docs.jiniu.ai/277810400d0.md): 
- [ImageResponse](https://docs.jiniu.ai/277810401d0.md): 
- [ModelList](https://docs.jiniu.ai/277810402d0.md):