Aetheris

API ドキュメント

v1.0.0
OpenAPI 3.0.1

AI模型接口

接口
28
分类
18
Schema
52
28 / 28
GET/v1/models获取模型列表
获取模型列表

获取当前可用的模型列表。 根据请求头自动识别返回格式： - 包含 `x-api-key` 和 `anthropic-version` 头时返回 Anthropic 格式 - 包含 `x-goog-api-key` 头或 `key` 查询参数时返回 Gemini 格式 - 其他情况返回 OpenAI 格式

请求参数

名称位置类型必填
keyGoogle API Key (用于 Gemini 格式)querystring可选
x-api-keyAnthropic API Key (用于 Claude 格式)headerstring可选
anthropic-versionAnthropic API 版本headerstring可选
x-goog-api-keyGoogle API Key (用于 Gemini 格式)headerstring可选

响应

200成功获取模型列表ModelsResponse · application/json
401认证失败ErrorResponse · application/json
GET/v1beta/modelsGemini 格式获取
获取模型列表

以 Gemini API 格式返回可用模型列表

响应

200成功获取模型列表GeminiModelsResponse · application/json
POST/v1/chat/completions创建聊天对话
OpenAI格式(Chat)

根据对话历史创建模型响应。支持流式和非流式响应。 兼容 OpenAI Chat Completions API。

请求体

必填ChatCompletionRequest内容类型: application/json

响应

200成功创建响应ChatCompletionResponse · application/json
400请求参数错误ErrorResponse · application/json
429请求频率限制ErrorResponse · application/json
POST/v1/responses创建响应 (OpenAI Responses API)
OpenAI格式(Responses)

OpenAI Responses API，用于创建模型响应。 支持多轮对话、工具调用、推理等功能。

请求体

必填ResponsesRequest内容类型: application/json

响应

200成功创建响应ResponsesResponse · application/json
POST/v1/responses/compact压缩对话 (OpenAI Responses API)
OpenAI格式(Responses)

OpenAI Responses API，用于对长对话进行 compaction。

请求体

必填ResponsesCompactionRequest内容类型: application/json

响应

200成功压缩对话ResponsesCompactionResponse · application/json
POST/v1/images/generations生成图像(qwen-image)
图片生成/Qwen千问

百炼qwen-image系列图片生成

请求体

可选object内容类型: application/json

响应

200成功生成图像ImageResponse · application/json
POST/v1/images/edits编辑图像(qwen-image-edit)
图片生成/Qwen千问

百炼qwen-image系列图片生成

请求体

可选object内容类型: application/json

响应

200成功生成图像ImageResponse · application/json
POST/v1/videos创建视频
视频生成/Sora兼容格式

OpenAI 兼容的视频生成接口。 参考文档: https://platform.openai.com/docs/api-reference/videos/create

请求体

可选object内容类型: multipart/form-data

响应

200成功创建视频任务object · application/json
400请求参数错误ErrorResponse · application/json
GET/v1/videos/{task_id}获取视频任务状态
视频生成/Sora兼容格式

OpenAI 兼容的视频任务状态查询接口。 返回视频任务的详细状态信息。

请求参数

名称位置类型必填
task_id视频任务 IDpathstring必填

响应

200成功获取视频任务状态object · application/json
404任务不存在ErrorResponse · application/json
GET/v1/videos/{task_id}/content获取视频内容
视频生成/Sora兼容格式

获取已完成视频任务的视频文件内容。 此接口会代理返回视频文件流。

请求参数

名称位置类型必填
task_id视频任务 IDpathstring必填

响应

200成功获取视频内容string · video/mp4
404视频不存在或未完成ErrorResponse · application/json
POST/kling/v1/videos/text2videoKling 文生视频
视频生成/Kling格式

使用 Kling 模型从文本描述生成视频。 支持的模型：kling-v1, kling-v1-5 等

请求体

可选VideoRequest内容类型: application/json

响应

200成功创建视频生成任务VideoResponse · application/json
400请求参数错误ErrorResponse · application/json
GET/kling/v1/videos/text2video/{task_id}获取 Kling 文生视频任务状态
视频生成/Kling格式

查询 Kling 文生视频任务的状态和结果。

请求参数

名称位置类型必填
task_id任务 IDpathstring必填

响应

200成功获取任务状态VideoTaskResponse · application/json
404任务不存在ErrorResponse · application/json
POST/kling/v1/videos/image2videoKling 图生视频
视频生成/Kling格式

使用 Kling 模型从图片生成视频。 支持通过 image 参数传入图片 URL 或 Base64 编码的图片数据。

请求体

可选VideoRequest内容类型: application/json

响应

200成功创建视频生成任务VideoResponse · application/json
400请求参数错误ErrorResponse · application/json
GET/kling/v1/videos/image2video/{task_id}获取 Kling 图生视频任务状态
视频生成/Kling格式

查询 Kling 图生视频任务的状态和结果。

请求参数

名称位置类型必填
task_id任务 IDpathstring必填

响应

200成功获取任务状态VideoTaskResponse · application/json
404任务不存在ErrorResponse · application/json
POST/jimeng/即梦视频生成
视频生成/即梦格式

即梦官方 API 格式的视频生成接口。 支持通过 Action 参数指定操作类型： - `CVSync2AsyncSubmitTask`: 提交视频生成任务 - `CVSync2AsyncGetResult`: 获取任务结果 需要在查询参数中指定 Action 和 Version。

请求参数

名称位置类型必填
ActionAPI 操作类型queryCVSync2AsyncSubmitTask | CVSync2AsyncGetResult必填
VersionAPI 版本querystring必填

请求体

可选object内容类型: application/json

响应

200成功处理请求object · application/json
400请求参数错误ErrorResponse · application/json
POST/v1/video/generations创建视频生成任务
视频生成

提交视频生成任务，支持文生视频和图生视频。 返回任务 ID，可通过 GET 接口查询任务状态。

请求体

必填VideoRequest内容类型: application/json

响应

200成功创建视频生成任务VideoResponse · application/json
400请求参数错误ErrorResponse · application/json
GET/v1/video/generations/{task_id}获取视频生成任务状态
视频生成

查询视频生成任务的状态和结果。 任务状态： - `queued`: 排队中 - `in_progress`: 生成中 - `completed`: 已完成 - `failed`: 失败

请求参数

名称位置类型必填
task_id任务 IDpathstring必填

响应

200成功获取任务状态VideoTaskResponse · application/json
404任务不存在ErrorResponse · application/json
POST/v1/messagesClaude 聊天
Claude格式(Messages)

Anthropic Claude Messages API 格式的请求。 需要在请求头中包含 `anthropic-version`。

请求参数

名称位置类型必填
anthropic-versionAnthropic API 版本headerstring必填
x-api-keyAnthropic API Key (可选，也可使用 Bearer Token)headerstring可选

请求体

可选ClaudeRequest内容类型: application/json

响应

200成功创建响应ClaudeResponse · application/json
POST/v1beta/models/{model}:generateContentGemini 图片(Nano Banana)
Gemini格式

Gemini 图片生成

请求参数

名称位置类型必填
model模型名称pathstring必填

请求体

可选object内容类型: application/json

响应

200成功GeminiResponse · application/json
POST/v1/engines/{model}/embeddingsGemini 嵌入(Embeddings)
Gemini格式

使用指定引擎/模型创建嵌入

请求参数

名称位置类型必填
model模型/引擎 IDpathstring必填

请求体

可选EmbeddingRequest内容类型: application/json

响应

200成功创建嵌入EmbeddingResponse · application/json
POST/v1/embeddings创建文本嵌入
OpenAI格式(Embeddings)

将文本转换为向量嵌入

请求体

必填EmbeddingRequest内容类型: application/json

响应

200成功创建嵌入EmbeddingResponse · application/json
POST/v1/completions创建文本补全
文本补全(Completions)

基于给定提示创建文本补全

请求体

必填CompletionRequest内容类型: application/json

响应

200成功创建响应CompletionResponse · application/json
POST/v1/audio/transcriptions音频转录
OpenAI音频(Audio)

将音频转换为文本

请求体

必填object内容类型: multipart/form-data

响应

200成功转录AudioTranscriptionResponse · application/json
POST/v1/audio/translations音频翻译
OpenAI音频(Audio)

将音频翻译为英文文本

请求体

必填object内容类型: multipart/form-data

响应

200成功翻译AudioTranscriptionResponse · application/json
POST/v1/audio/speech文本转语音
OpenAI音频(Audio)

将文本转换为音频

请求体

必填SpeechRequest内容类型: application/json

响应

200成功生成音频string · audio/mpeg
POST/v1/rerank文档重排序
重排序(Rerank)

根据查询对文档列表进行相关性重排序

请求体

必填RerankRequest内容类型: application/json

响应

200成功重排序RerankResponse · application/json
POST/v1/moderations内容审核
Moderations

检查文本内容是否违反使用政策

请求体

必填ModerationRequest内容类型: application/json

响应

200成功审核ModerationResponse · application/json
GET/v1/realtime实时 WebSocket 连接
Realtime

建立 WebSocket 连接用于实时对话。 **注意**: 这是一个 WebSocket 端点，需要使用 WebSocket 协议连接。 连接 URL 示例: `wss://api.example.com/v1/realtime?model=gpt-4o-realtime`

请求参数

名称位置类型必填
model要使用的模型querystring可选

响应

101WebSocket 协议切换-
400请求错误ErrorResponse · application/json

数据结构

52
ErrorResponseobject1 fields
Usageobject5 fields
Modelobject4 fields
ModelsResponseobject2 fields
GeminiModelsResponseobject1 fields
Messageobject6 fields
MessageContentobject6 fields
ToolCallobject3 fields
Toolobject2 fields
ResponseFormatobject2 fields
ChatCompletionRequestobject21 fields
ChatCompletionResponseobject7 fields
ChatCompletionStreamResponseobject6 fields
CompletionRequestobject10 fields
CompletionResponseobject6 fields
ResponsesRequestobject12 fields
ResponsesResponseobject7 fields
ResponsesCompactionResponseobject6 fields
ResponsesCompactionRequestobject4 fields
ResponsesStreamResponseobject4 fields
ClaudeRequestobject22 fields
ClaudeMessageobject2 fields
ClaudeResponseobject7 fields
EmbeddingRequestobject4 fields
EmbeddingResponseobject4 fields
ImageGenerationRequestobject8 fields
ImageEditRequestobject7 fields
ImageResponseobject2 fields
AudioTranscriptionRequestobject7 fields
AudioTranslationRequestobject5 fields
AudioTranscriptionResponseobject1 fields
SpeechRequestobject5 fields
RerankRequestobject5 fields
RerankResponseobject3 fields
ModerationRequestobject2 fields
ModerationResponseobject3 fields
GeminiRequestobject5 fields
GeminiResponseobject2 fields
VideoRequestobject12 fields
VideoResponseobject2 fields
VideoTaskResponseobject6 fields
VideoTaskMetadataobject5 fields
VideoTaskErrorobject2 fields
OpenAIVideoobject14 fields
OpenAIVideoErrorobject2 fields
ApiResponseobject3 fields
PageInfoobject4 fields
Userobject10 fields
Channelobject10 fields
Tokenobject8 fields
Redemptionobject7 fields
Logobject5 fields