> ## Documentation Index > Fetch the complete documentation index at: https://docs.maxapi.ai/llms.txt > Use this file to discover all available pages before exploring further. # 4.Create Character(通过任务创建角色--可创建真人角色) > 根据视频url和指定片段，创建角色。 后续可用于 @ 调用，注意调用角色需要跟 prompt 有空格隔开 例如：@{角色1Username} 在一个舞台上和 @{角色2Username} 牵手跳舞 ## OpenAPI ````yaml /api-reference/openapi.json post /v1/videos openapi: 3.0.1 info: title: MaxAPI 模型 API description: MaxAPI 文本、图像、视频、音频和音乐模型接口。 version: 1.0.0 servers: - url: https://api.maxapi.ai description: MaxAPI 生产环境 security: [] tags: - name: 模型接口 - name: 模型接口/绘图模型 - name: 模型接口/绘图模型/OpenAI Dall-e 格式 - name: 模型接口/绘图模型/Flux系列 - name: 模型接口/绘图模型/Flux系列/OpenAI Dalle 格式 - name: 模型接口/绘图模型/Z-image - name: 模型接口/绘图模型/Banana生图异步格式(未来可能兼容其他模型) - name: 模型接口/聊天接口（Chat） - name: 模型接口/视频模型 - name: 模型接口/视频模型/谷歌veo - name: 模型接口/视频模型/谷歌veo/VertexAI-VEO官方格式 - name: 模型接口/视频模型/谷歌veo/VertexAI-VEO官方格式/视频生成 - name: 模型接口/视频模型/谷歌veo/VertexAI-VEO官方格式/任务查询 - name: 模型接口/视频模型/谷歌veo/AIStudio-VEO官方格式 - name: 模型接口/视频模型/谷歌veo/AIStudio-VEO官方格式/视频生成 - name: 模型接口/视频模型/谷歌veo/AIStudio-VEO官方格式/任务查询 - name: 模型接口/视频模型/谷歌veo/AIStudio-VEO官方格式/下载视频(只有aistudio有这个动作) - name: 模型接口/视频模型/谷歌veo/GCP异步任务接口 - name: 模型接口/视频模型/谷歌veo/官网逆向接口格式 - name: 模型接口/视频模型/谷歌veo/官网逆向接口格式/视频生成 - name: 模型接口/视频模型/谷歌veo/官网逆向接口格式/OpenAI官方视频格式(适配 newapi) - name: 模型接口/视频模型/Wan阿里万象(官方格式) - name: 模型接口/视频模型/豆包seedance(官方格式) - name: 模型接口/视频模型/Vidu官方格式 - name: 模型接口/视频模型/Vidu官方格式/视频生成 - name: 模型接口/视频模型/Vidu官方格式/图像生成 - name: 模型接口/视频模型/Vidu官方格式/音频生成 - name: 模型接口/视频模型/Vidu官方格式/其他功能 - name: 模型接口/视频模型/Vidu官方格式/任务管理 - name: 模型接口/视频模型/MiniMax-Hailuo官方格式 - name: 模型接口/视频模型/MiniMax-Hailuo官方格式/视频生成 - name: 模型接口/视频模型/MiniMax-Hailuo官方格式/任务管理 - name: 模型接口/视频模型/MiniMax-Hailuo-OpenAI-Sora兼容格式 - name: 模型接口/视频模型/MiniMax-Hailuo-OpenAI-Sora兼容格式/视频生成 - name: 模型接口/视频模型/Sora-2-官方格式 - name: 模型接口/视频模型/Sora-2-官方格式/创建角色接口 - name: 模型接口/视频模型/Sora-2026-01-07新格式 - name: 模型接口/自动补全接口（Completions） - name: 模型接口/图像接口（Images） - name: 模型接口/向量生成接口（Embeddings） - name: 模型接口/音频接口（Audio） - name: 模型接口/MJ图像(视频)接口 - name: 模型接口/MJ图像(视频)接口/InsightFace任务提交 - name: 模型接口/MJ图像(视频)接口/任务提交 - name: 模型接口/MJ图像(视频)接口/任务查询 - name: 模型接口/MJ图像(视频)接口/MJ视频相关 - name: 模型接口/Suno音乐接口 - name: 模型接口/Suno音乐接口/GoAmzAI格式 - name: 模型接口/Suno音乐接口/GoAmzAI格式/v3.5 - name: 模型接口/Suno音乐接口/GoAmzAI格式/v3.0 - name: 模型接口/Suno音乐接口/官网原生格式(v2) - name: 模型接口/Suno音乐接口/官网原生格式(v2)/所有接口 - name: 模型接口/Suno音乐接口/官网原生格式(v2)/场景1 生成自定义音乐(带歌词) - name: 模型接口/Suno音乐接口/官网原生格式(v2)/场景 2 通过提示词直接生成音乐(带歌词) - name: 模型接口/Suno音乐接口/官网原生格式(v2)/场景 4 通过提示词直接生成音乐(纯音乐) - name: 模型接口/Suno音乐接口/官网原生格式(v2)/场景3 生成自定义音乐(纯音乐) - name: 模型接口/Suno音乐接口/官网原生格式(v2)/场景 5 上传自定义音频并续写 - name: 模型接口/Suno音乐接口/生成歌词 - name: 模型接口/Suno音乐接口/NewAPI兼容格式 - name: 模型接口/Luma视频接口 - name: 模型接口/Luma视频接口/GoAmzAI格式 - name: 模型接口/Luma视频接口/GoAmzAI格式/付费版 - name: 模型接口/Luma视频接口/GoAmzAI格式/免费版 - name: 模型接口/Luma视频接口/官网原生格式(v2) - name: 模型接口/SD图像接口 - name: 模型接口/SD图像接口/SD3 - name: 模型接口/SD图像接口/SDXL - name: 模型接口/Fish Audio - name: 模型接口/统一视频接口 - name: 模型接口/统一视频接口/阿里Wan(万相视频 - name: 模型接口/统一视频接口/Sora2视频 - name: 模型接口/统一视频接口/Seedance(即梦视频 - name: 模型接口/统一视频接口/Google-Veo - name: 历史接口 - name: 历史接口/PPT类接入 - name: 历史接口/请求示例 - name: 历史接口/原始接口（参数需要定义后才能发送请求） - name: 佐糖API - name: MewXAI星月熊开放API - name: MewXAI星月熊开放API/开放API接口 - name: MewXAI星月熊开放API/示例 - name: Ideogram（绘画） - name: 可灵API - name: RunWay官方API - name: 视频生成 - name: 任务查询 - name: Wan官方格式 - name: 图像生成 - name: 音频生成 - name: 其他功能 - name: 任务管理 - name: InsightFace任务提交 - name: 任务提交 - name: Generate - name: SDXL & SD1.6 paths: /v1/videos: post: tags: - 模型接口/视频模型/Sora-2026-01-07新格式 summary: 4.Create Character(通过任务创建角色--可创建真人角色) description: |- 根据视频url和指定片段，创建角色。 后续可用于 @ 调用，注意调用角色需要跟 prompt 有空格隔开 例如：@{角色1Username} 在一个舞台上和 @{角色2Username} 牵手跳舞 parameters: - name: Authorization in: header description: 用户个人中心获取的密钥 required: true example: YOUR_API_KEY schema: type: string requestBody: content: application/json: schema: type: object properties: model: type: string title: 模型 description: 角色创建固定模型：sora-2-character enum: - sora-2-character url: type: string title: 视频url description: 用于创建角色的视频链接 timestamps: type: string title: 时间范围 description: 相隔时间不能大于3秒 required: - model - url - timestamps example: model: sora-2-character prompt: 创建角色 url: >- https://filesystem.site/cdn/20251030/javYrU4etHVFDqg8by7mViTWHlMOZy.mp4 timestamps: 1,3 responses: '200': description: 请求成功 content: application/json: schema: type: object properties: id: type: string description: 任务id object: type: string model: type: string description: 模型名 status: type: string description: 任务状态 progress: type: string description: 任务进度 nullable: true username: type: string description: 角色名 avatar_url: type: string description: 角色头像 video_url: type: string description: 视频 created_at: type: integer description: 创建时间 completed_at: type: string description: 完成时间 nullable: true expires_at: type: string description: 过期时间 nullable: true size: type: string description: 分辨率 seconds: type: integer description: 时长 remixed_from_video_id: type: string description: remix的视频id nullable: true error: type: string description: 错误信息 nullable: true required: - id - object - model - status - progress - created_at - completed_at - expires_at - size - seconds - remixed_from_video_id - error - username - avatar_url - video_url examples: '1': summary: 成功示例 value: id: char_2f7a568b-4541-41b6-b491-35e8c17a493d object: character model: sora-2-character status: queued progress: 0 username: null avatar_url: null video_url: null created_at: 1766681833 completed_at: null expires_at: null size: null seconds: null remixed_from_video_id: null error: null '2': summary: 异常示例 value: code: 1003 description: Secret key is invalid! result: null headers: {} deprecated: false security: [] ````