平台 API 接入

第一版平台 API 仅开放图片和视频模型，统一入口为平台主域名的 /openapi/v1 路径。文本模型暂不属于本阶段开放范围。

认证

所有请求使用平台 API Key：

Authorization: Bearer PLATFORM_API_KEY
Content-Type: application/json
Idempotency-Key: REQUEST_ID

查询模型

GET https://aimaxa.cn/openapi/v1/models

返回的模型名称、编码和价格以模型广场为准。视频特价版与标准版使用独立模型编码，详情页会展示对应调用方式和价格。每个模型的描述、支持参数和参数约束由平台模型配置统一维护；请以模型详情和该文档中的示例为准，不要依赖未声明的字段。

图片生成

curl https://aimaxa.cn/openapi/v1/images/generations \
  -H "Authorization: Bearer PLATFORM_API_KEY" \
  -H "Idempotency-Key: REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{"model":"MODEL_CODE","prompt":"未来城市","params":{}}'

视频生成

curl https://aimaxa.cn/openapi/v1/videos/generations \
  -H "Authorization: Bearer PLATFORM_API_KEY" \
  -H "Idempotency-Key: REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{"model":"MODEL_CODE","prompt":"海边日落","reference_asset_ids":[],"params":{}}'

图片和视频均采用异步任务协议，提交成功后返回 task_id 与 task_no。

查询任务

GET https://aimaxa.cn/openapi/v1/tasks/TASK_ID

任务状态包括排队、处理中、成功和失败，成功后通过 works 获取结果资源。

费用与日志

图片和视频调用会先冻结平台账户余额，任务完成后按实际价格结算，失败任务按规则释放或退款。图片和视频请求会生成异步任务并记录在任务日志；余额冻结、结算和充值退款记录在消费日志。网关内部仍保留请求审计，控制台暂不展示单独的使用日志。控制台概览中的“近 7 日模型消费”按日期和模型统计图片/视频的实际结算金额，不包含文本、充值或其他业务流水。

文本接口

第一版暂不开放文本模型。后续开放时会在同一平台 API 体系下增加文本路由，不改变图片、视频接口协议。

开始使用

图像模型

视频模型

文本模型

平台 API 接入

平台 API 接入

认证

查询模型

图片生成

视频生成

查询任务

费用与日志

文本接口

​平台 API 接入

​认证

​查询模型

​图片生成

​视频生成

​查询任务

​费用与日志

​文本接口

平台 API 接入

认证

查询模型

图片生成

视频生成

查询任务

费用与日志

文本接口