API 接入总览 - Mintlify Starter Kit

AiSDK 对外优先提供 OpenAI 兼容风格接口。

基本信息

Base URL：https://your-domain/v1
鉴权方式：Authorization: Bearer <YOUR_API_KEY>
内容类型：application/json

主要接口

能力	方法	路径
文生图片	POST	`/v1/images/generations`
图片编辑	POST	`/v1/images/edits`
文生视频	POST	`/v1/videos`
兼容旧视频路径	POST	`/v1/video/generations`
视频任务查询	GET	`/v1/videos/:task_id`
旧视频任务查询	GET	`/v1/video/generations/:task_id`
视频内容获取	GET	`/v1/videos/:task_id/content`

推荐调用链路

图片生成

调用 /v1/images/generations
传入 model、prompt、可选的 size、n
从返回体读取图片 URL 或 Base64 结果

视频生成

调用 /v1/videos
传入 model 和相关视频参数；MiniMax H3 原生请求将提示词放在 content[].text，详见 MiniMax 快速开始
从 /v1/videos 返回体的 id 字段拿到公开任务 ID，用作后续路径中的 task_id
轮询 /v1/videos/:task_id
成功后按需访问 /v1/videos/:task_id/content

已集成模型范围

当前文档优先覆盖这些模型族：

文生图片：image2、OG image2、Kling、Vidu
文生视频：Seedance、Kling 3.0、Vidu q3、MiniMax H3 / H3-Max / H3-Turbo