302.AI API文档
  1. 营销数字人
  • 语言大模型
    • 迁移API指南
    • 独家功能
      • MCP调用
        • Chat（MCP调用）
      • 联网搜索
        • Chat（联网搜索）
      • 深度搜索
        • Chat（深度搜索）
      • 图片分析
        • Chat（图片分析）
      • 推理模式
        • Chat（推理模式）
      • 链接解析
        • Chat（链接解析）
      • 工具调用
        • Chat（工具调用）
      • 长期记忆（Beta）
        • Memobase
          • 用户管理
            • Create User（创建用户）
            • Get User（获取用户信息）
            • Update User（更新用户信息）
            • Delete User（删除用户）
          • 数据管理
            • Insert Data（插入数据）
            • Get Datas（获取数据列表）
            • Get Data（获取单个数据）
            • Delete Data（删除单个数据）
          • 记忆管理
            • Flush Buffer（生成记忆）
            • Get User Profile（获取记忆）
            • Delet User Profile（删除记忆）
            • Add User Profile
            • Update User Profile
          • 事件管理
            • Get User Recent Events
            • Search Events
            • Update User Event
            • Delete User Event
          • Prompt
            • Get User Personalized Context
        • Chat（长期记忆）
      • 简化版API
        • Chat（简化版API）
      • 异步调用
        • 异步请求Chat
        • 异步获取结果
    • 列出模型
      • Models（列出模型）
      • Status（模型状态）
    • OpenAI
      • Chat（聊天）
      • Chat（流式返回）
      • Chat（gpt-4o 分析图片）
      • Chat（gpt-4o 结构化输出）
      • Chat（gpt-4o 工具调用）
      • Chat（gpt-4o-plus 分析图片）
      • Chat（gpt-4o-plus 生成图片）
      • Chat（gpt-4o-image-generation 修改图片）
      • Chat（gpts模型）
      • Chat（chatgpt-4o-latest）
      • Chat（o1系列）
      • Chat（o3系列）
      • Chat（o4系列）
      • Chat（gpt-4o 语音模型）
      • Responses（聊天）
      • Responses（Deep-Research）
    • Anthropic
      • Chat（聊天）
      • Chat（分析图片）
      • Chat（函数调用）
      • Messages（原始格式）
      • Messages（函数调用）
      • Messages（思考模式）
      • Messages（128k输出）
    • Gemini
      • Chat（聊天）
      • Chat（分析图片）
      • Chat（图片生成）
    • 国产模型
      • Chat（文心一言）
      • Chat（通义千问）
      • Chat（通义千问多模态）
      • Chat（通义千问-OCR）
      • Chat（智谱GLM-4）
      • Chat（智谱GLM-4多模态）
      • Chat（百川AI）
      • Chat（月之暗面）
      • Chat（月之暗面多模态）
      • Chat（零一万物）
      • Chat（零一万物多模态）
      • Chat（讯飞星火）
      • Chat（Deepseek）
      • Chat（Deepseek多模态）
      • Chat（阶跃星辰）
      • Chat（阶跃星辰多模态）
      • Chat（字节豆包）
      • Chat（字节豆包多模态）
      • Chat（字节豆包图片生成）
      • Chat（商汤日日新）
      • Chat（Minimax）
      • Chat（腾讯混元）
    • 硅基流动
      • Chat（硅基流动）
    • PPIO派欧云
      • Chat（PPIO派欧云）
    • SophNet
      • Chat（SophNet）
    • 开源模型
      • Chat（LLaMA4）
      • Chat（LLaMA3.3）
      • Chat（LLaMA3.2多模态）
      • Chat（LLaMA3.1）
      • Chat（Mistral）
      • Chat（Pixtral-Large-2411多模态）
      • Chat（Gemma-7B、Gemma-3-27b-it）
      • Chat（Gemma2-9B）
      • Chat（Command R+）
      • Chat（Qwen2）
      • Chat（Qwen2.5）
      • Chat（Qwen2.5-VL）
      • Chat（Qwen3）
      • Chat（Llama-3.1-nemotron）
      • Chat（QwQ-32B、QwQ-Plus、QwQ-32B-Preview）
    • 专业模型
      • Chat（WiseDiag医学模型）
      • Chat（ChatLaw法律模型）
      • Chat（轩辕金融模型）
      • Chat（法睿法律模型）
      • Chat（阿里数学模型）
      • Chat（Perplexity搜索）
    • 其他模型
      • Chat（grok）
      • Chat（grok-2-vision）
      • Chat（Nova）
      • Chat（v0）
  • 图片生成
    • 统一接口
      • 说明
      • 图片生成（302格式）
      • 图片生成（OpenAI格式）
      • 图片编辑（OpenAI格式）
    • GPT-Image-1
      • Generations（生成图片）
      • Edits（修改图片）
      • 异步获取图片
    • DALL.E
      • Generations（DALL·E 3和DALL·E 2）
      • Edits（DALL·E 2）
      • Variations（DALL·E 2）
    • Stability.ai
      • Text-to-image（图片生成-V1）
      • Generate（图片生成-SD2）
      • Generate（图片生成-SD3-Ultra）
      • Generate（图片生成-SD3）
      • Generate（图片生成-SD3.5-Large）
      • Generate（图片生成-SD3.5-Medium）
      • Generate（图生图-SD3）
      • Generate（图生图-SD3.5-Large）
      • Generate（图生图-SD3.5-Medium）
    • Midjourney
      • Imagine（绘画）
      • Action（修改）
      • Blend（混图）
      • Describe（描述图片）
      • Modal（局部重绘）
      • Edits（提交编辑）
      • Fetch（获取任务）
      • Cancel（取消任务）
    • Midjourney-Relax
      • Imagine（绘画）
      • Action（修改）
      • Blend（混图）
      • Describe（描述图片）
      • Modal（局部重绘）
      • Fetch（获取任务）
      • Cancel（取消任务）
    • 302.AI
      • SDXL（图片生成）
      • SDXL-Lora（图片生成-Lora）
      • SDXL-Lightning（快速图片生成）
      • SDXL-Lightning-V2（快速图片生成V2）
      • SD3（图片生成-SD3）
      • Aura-Flow（图片生成）
      • Kolors（图片生成-可灵）
      • Kolors（参考图片生成-可灵）
      • QRCode（艺术二维码生成）
      • Lora（图片生成-Lora）
      • Lora（获取任务结果）
      • SD-3.5-Large（图片生成）
      • SD-3.5-Large-Turbo（图片生成）
      • SD-3.5-Medium（图片生成）
      • Lumina-Image-V2（图片生成）
      • Playground-v25（图片生成）
      • Omnigen-V1（图片生成）
    • Glif
      • Glif（Claude+SD3）
      • Glif（文字生成贴纸）
      • Glif（文字生成涂鸦）
      • Glif（文字生成Wojak漫画）
      • Glif（文字生成乐高）
    • Flux
      • 官方API
        • Generate（生成图片）
        • Finetune（微调）
        • Result（查询任务）
      • Flux-Ultra-v1.1（图片生成v1.1）
      • Flux-Pro-v1.1（图片生成v1.1）
      • Flux-Pro（图片生成）
      • Flux-Dev（图片生成）
      • Flux-Schnell（图片生成）
      • Flux-Realism（超真实Lora）
      • Flux-Lora（自定义Lora）
      • Flux-General（高级自定义）
      • Flux-General-Inpainting（高级自定义）
      • Flux-Lora-Training（训练Lora）
      • Flux-Lora-Training（异步获取结果）
    • Ideogram
      • Generate（文字生成图片V3）
      • Generate（文字生成图片）
    • Recraft
      • Recraft-V3（图片生成）
      • Create-Style（自定义风格）
      • Recraft-20B（图片生成）
    • Luma
      • Luma-Photon（图片生成）
      • Luma-Photon-Flash（快速图片生成）
    • Doubao即梦
      • Generations（Seedream 3.0）
      • Generations（SeedEdit 3.0）
      • Drawing（即梦图片生成）
    • Google
      • Imagen-4-Preview （图片生成）
      • Imagen-3 （图片生成）
      • Imagen-3-Fast（图片生成）
    • Minimax海螺
      • image（文字生成图片）
    • 智谱
      • image（文字生成图片）
    • Baidu百度
      • iRAG(文字生成图片)
    • Hidream
      • Hidream-i1-full（高级版）
      • Hidream-i1-dev（中级版）
      • Hidream-i1-fast（入门版）
    • Bagel
      • Bagel（图片生成）
    • 硅基流动
      • 创建图片生成请求
    • Higgsfield
      • Soul（文字生图片）
      • Character（生成角色）
      • Fetch（获取任务结果）
    • Kling可灵
      • Images-Generations（生成图像）
      • Fetch（获取生成图像任务结果）
  • 图片处理
    • 302.AI-ComfyUI
      • 创建换装任务
      • 创建换装任务（上传遮罩）
      • 查询换装任务状态
      • 创建换脸任务
      • 查询换脸任务状态
      • 创建换任意物品任务
      • 创建换任意物品任务（上传遮罩）
      • 查询换任意物品任务状态
      • 创建漫画人物变真人任务
      • 查询漫画人物变真人任务状态
      • 创建风格迁移任务
      • 查询风格迁移任务状态
      • 创建图片消除任务
      • 查询图片消除任务状态
      • 创建视频换脸任务
      • 查询视频换脸任务状态
      • 创建视频换脸任务（V2）
      • 查询视频换脸任务状态（V2）
    • 302.AI
      • Upscale（图片放大）
      • Upscale-V2（图片放大V2）
      • Upscale-V3（图片放大V3）
      • Upscale-V4（图片放大V4）
      • Super-Upscale（超级图片放大）
      • Super-Upscale-V2（超级图片放大V2）
      • Face-upscale（人像照片放大）
      • Colorize（黑白照片上色）
      • Colorize（黑白照片上色V2）
      • Removebg（背景消除）
      • Removebg-V2（背景消除V2）
      • Removebg-V3（背景消除V3）
      • Inpaint（图片修改）
      • Erase（物体消除）
      • Face-to-many（人像照片风格化）
      • Llava（图像识别）
      • Relight（二次打光）
      • Relight-background（二次打光背景合成）
      • Relight-V2（二次打光-V2）
      • Face-swap-V2（AI换脸V2）
      • Fetch（获取任务结果）
      • HtmltoPng（HTML转PNG格式）
      • SvgToPng（SVG转PNG格式）
      • image-translate（图片翻译）
      • image-translate-query（图片翻译结果）
      • image-translate-redo（图片翻译修改）
      • Flux-selfie（自拍照片风格化）
      • Trellis（图片转3D模型）
      • Pose-Transfer（人物姿态变换）
      • Pose-Transfer（人物姿态变换结果）
      • Virtual-Tryon（虚拟穿衣）
      • Virtual-Tryon（虚拟穿衣结果）
      • Denoise（AI降噪）
      • Deblur（AI去模糊）
      • SAM（AI生成MASK图）
    • Vectorizer
      • vectorize（矢量化）
    • Stability.ai
      • Fast Upscale（快速图片放大）
      • Creative Upscale（创意图片放大）
      • Conservative Upscale（保守图片放大）
      • Fetch Creative Upscale（超级图片放大）
      • Erase（物体消除）
      • Inpaint（图片修改）
      • Outpaint（图片扩展）
      • Search-and-replace（内容替换）
      • Search-and-recolor（内容重着色）
      • Remove-background（背景消除）
      • Sketch（草图转图片）
      • Structure（以图生图）
      • Style（风格一致性）
      • Replace-Background（更换背景）
      • Stable-Fast-3D（图片转3D模型）
      • Stable-Point-3D（图片转3D模型新版）
    • Glif
      • Glif（人物照片风格化）
      • Glif（照片转化成雕塑）
      • Glif（照片像素化）
      • Glif（logo材质化）
      • Glif（图片生成GIF）
    • Clipdrop
      • Cleanup（物体消除）
      • Upscale（AI放大）
      • Remove-background（背景消除）
      • Uncrop（图像扩展）
    • Recraft
      • Vectorize Image（矢量化图片）
      • Remove Background（背景消除）
      • Clarity Upscale（图片放大）
      • Generative Upscale（图片创意放大）
    • BRIA
      • Remove Background（背景消除）
      • Blur Background（背景模糊）
      • Generate Background（背景生成）
      • Erase Foreground（擦除前景）
      • Eraser（物体擦除）
      • Expand Image（图片扩展）
      • Increase Resolution（图片放大）
      • Crop（图片裁切）
      • Cutout（产品图裁剪）
      • Packshot（产品图特写）
      • Shadow （产品图阴影）
      • Scene （产品图场景生成）
      • Caption（图片描述）
      • Register（图片上传）
      • Mask（图片分割）
      • Presenter info (人脸分析)
      • Modify Presenter（人脸修改）
      • Delayer Image（图片转PSD）
    • Flux
      • 官方API
        • Generate（修改图片）
        • Result（查询任务）
      • Flux-V1.1-Ultra-Redux（以图生图-Ultra）
      • Flux-V1.1-Pro-Redux（以图生图-Pro）
      • Flux-Dev-Redux（以图生图-Dev）
      • Flux-Schnell-Redux（以图生图-Schnell）
      • Flux-V1-Pro-Canny（物体一致性）
      • Flux-V1-Pro-Depth（深度一致性）
      • Flux-V1-Pro-Fill（局部重绘）
      • Flux-Kontext-Pro（图片编辑）
      • Flux-Kontext-Max（图片编辑）
    • Hyper3D
      • Hyper3d-Rodin（生成3D模型）
      • Hyper3d-Rodin（获取任务结果）
    • Tripo3D
      • Task（任务提交）
      • Upload（图片上传）
      • Fetch（获取结果）
    • FASHN
      • Fashn-Tryon（虚拟穿衣）
      • Fashn-Tryon（虚拟穿衣v1.5）
    • Ideogram
      • Edit（图片修改V3）
      • Remix（以图生图V3）
      • Reframe（图片扩展V3）
      • Replace Background（背景替换V3）
      • Remix（以图生图）
      • Upscale（图片放大）
      • Describe（图片描述）
      • Edit（图片修改）
    • Doubao即梦
      • SeedEdit_v3.0（图片指令编辑）
      • SeedEdit_v3.0（结果获取）
      • Portrait（人像写真）
      • Portrait（结果获取）
      • SeedEdit（图片指令编辑）
      • Character（角色特征保持）
    • Kling可灵
      • Virtual-Try-On（虚拟试穿）
      • Fetch（获取任务结果）
      • Images-expand（扩图）
      • Fetch（获取扩图任务结果）
    • 阶跃星辰
      • Step1x-Edit（图片修改）
    • Bagel
      • Bagel-Edit（图片编辑）
    • 共绩云
      • flux_dev
        • 创建flux_dev文生图任务
        • 创建flux_dev文生图任务
      • flux_kontext_dev
        • 创建flux_kontext_dev图片编辑任务
        • 查看flux_kontext_dev图片编辑任务
      • face_swapper
        • 创建face_swapper任务
        • 查询face_swapper任务
      • clothes_changer
        • 创建无遮罩换装任务
        • 查看无遮罩换装任务
        • 创建有遮罩换装任务
        • 查看有遮罩换装任务
  • 视频生成
    • 统一接口
      • 创建视频生成任务
      • 获取视频任务信息
    • 302.AI
      • Image-to-video（图片转视频）
      • Live-portrait（人像转视频）
      • Video-To-Video（视频风格迁移）
      • Fetch（获取视频结果）
      • Latentsync（开源数字人）
      • Latentsync（获取任务结果）
      • Upscale-Video（视频高清化）
      • Upscale-Video（获取视频结果）
    • Stable Diffusion
      • Image-to-video（图片生成视频）
      • Fetch Image-to-video（图片生成视频）
    • Luma AI
      • Submit（文字/图片生成视频）
      • Extend（视频扩展）
      • Fetch（获取任务结果）
    • Runway
      • Submit（文字生成视频）
      • Submit（图片生成视频 Gen-3）
      • Submit（图片生成视频 Gen-3-Turbo）
      • Submit（图片生成视频 Gen4）
      • Submit（图片生成视频 Gen4-Turbo）
      • Submit（视频生成视频）
      • Submit（视频快速生成视频）
      • Act-two（视频风格迁移）
      • Submit（视频扩展）
      • Fetch（获取任务结果）
    • Kling可灵
      • 302格式
        • 图生视频
          • Image2Video（图生视频1.0-快速-5秒）
          • Image2Video（图生视频1.0-快速-10秒）
          • Image2Video（图生视频1.5-快速-5秒）
          • Image2Video_HQ（图生视频1.5-高清-5秒）
          • Image2Video（图生视频1.5-快速-10秒）
          • Image2Video_HQ（图生视频1.5-高清-10秒）
          • Image2Video（图生视频1.6-标准-5秒）
          • Image2Video（图生视频1.6-标准-10秒）
          • Image2Video（图生视频1.6-高清-5秒）
          • Image2Video（图生视频1.6-高清-10秒）
          • Image2Video（多图参考）
          • Image2Video（图生视频2.0-高清-5秒）
          • Image2Video（图生视频2.0-高清-10秒）
          • Image2Video（图生视频2.1-5秒）
          • Image2Video（图生视频2.1-10秒）
          • Image2Video（图生视频2.1-高清-5秒）
          • Image2Video（图生视频2.1-高清-10秒）
          • Image2Video（图生视频2.1-大师版-5秒）
          • Image2Video（图生视频2.1-大师版-10秒）
        • 文生视频
          • Txt2Video（文生视频1.0-快速-5秒）
          • Txt2Video_HQ（文生视频1.5-高清-5秒）
          • Txt2Video_HQ（文生视频1.5-高清-10秒）
          • Txt2Video（文生视频1.6-标准-5秒）
          • Txt2Video（文生视频1.6-标准-10秒）
          • Txt2Video（文生视频1.6-高清-5秒）
          • Txt2Video（文生视频1.6-高清-10秒）
          • Txt2Video（文生视频2.0-高清-5秒）
          • Txt2Video（文生视频2.1-大师版-5秒）
          • Txt2Video（文生视频2.1-大师版-10秒）
        • Extend_Video（视频扩展）
        • Fetch（获取任务结果）
      • 官方格式
        • Text2video（文生视频 官方API）
        • Text2video（文生视频获取任务结果）
        • Image2video（图生视频 官方API）
        • Image2video（图生视频获取任务结果）
        • MultiImage2Video（多图参考）
        • MultiImage2Video（多图生视频获取任务结果）
        • Effects（视频特效 官方API）
        • Effects（视频特效获取任务结果）
    • CogVideoX智谱
      • Generations（文字生成视频）
      • Generations（图片生成视频）
      • Result（获取任务结果）
    • Minimax海螺
      • 视频模板提示词
      • Video（文字生成视频）
      • Video（图片生成视频）
      • Video（主体参照生成视频）
      • Video（运镜控制）
      • Video（MiniMax-Hailuo-02）
      • Query（任务查询）
      • Files（视频下载）
    • Pika
      • 1.5 pikaffects（图生成视频）
      • Turbo Generate（文字生成视频）
      • Turbo Generate（图生成视频）
      • 2.1 Generate（文字生成视频）
      • 2.1 Generate（图生成视频）
      • 2.2 Generate（文字生成视频）
      • 2.2 Generate（图生成视频）
      • 2.2 Pikascenes（生成场景视频）
      • Fetch（获取任务结果）
    • PixVerse
      • Pixverse特效ID
      • Pixverse音色ID
      • Generate（文字生成视频）
      • Generate（图片生成视频）
      • Generate（多主体参考）
      • Fetch（获取任务结果）
    • Genmo
      • Mochi-v1（文字生成视频）
      • Mochi-v1（获取任务结果）
    • Hedra
      • 2.0
        • Audio（音频上传）
        • Portrait（人像上传）
        • Characters（口型合成）
        • Fetch（获取任务结果）
      • 3.0
        • List Models（获取模型列表）
        • Create Asset（资源创建）
        • Upload Asset（资源上传）
        • Generate Asset（资源合成）
        • Get Status（获取资源合成结果）
    • Haiper
      • Haiper（文字生成视频）
      • Haiper（图片生成视频）
      • Haiper（文字生成视频V2.5）
      • Haiper（图片生成视频V2.5）
      • Haiper（获取任务结果）
    • Sync.
      • Generate（口型匹配）
      • Fetch（获取任务结果）
    • Lightricks
      • Ltx-Video（文字生成视频）
      • Ltx-Video-I2V（图片生成视频）
      • Ltx-Video-v095（文字生成视频）
      • Ltx-Video-v095-I2V（图片生成视频）
    • Hunyuan混元
      • Hunyuan（文字生成视频）
      • Hunyuan（获取任务结果）
    • Vidu
      • Vidu（文字生成视频）
      • Vidu（图片生成视频）
      • Vidu（首尾帧生成视频）
      • Vidu（参考主体生成视频）
      • Vidu（生成场景视频）
      • Vidu（智能超清）
      • Fetch（获取任务结果）
      • Vidu V2（文字生成视频）
      • Vidu V2（图片生成视频）
      • Vidu V2（首尾帧生成视频）
      • Vidu V2（参考主体生成视频）
      • Vidu V2（生成场景视频）
      • Vidu V2（智能超清-尊享）
      • Fetch V2（获取任务结果）
    • 通义万相
      • T2V（文字生成视频官方版）
      • Tasks（获取任务结果）
      • wan-t2v（文字生成视频开源版）
      • wan-t2v（获取任务结果）
      • wan-i2v（图片生成视频开源版）
      • wan-i2v（获取任务结果）
      • wan-vace（视频编辑）
      • wan-vace（获取任务结果）
    • 即梦
      • Seaweed（文/图生成视频）
      • Seaweed（获取任务结果）
      • Seedance(文/图生视频)
      • Seedance(获取任务结果)
    • 硅基流动
      • Video（生成视频）
      • Tasks（获取任务结果）
    • Google
      • Veo3-Fast（文字生成视频）
      • Veo3-Fast（获取任务结果）
      • Veo3-Fast-Frames（图文生成视频）
      • Veo3-Fast-Frames（获取任务结果）
      • Veo3-Pro（文字生成视频）
      • Veo3-Pro（获取任务结果）
      • Veo3-Pro-Frames（图文生成视频）
      • Veo3-Pro-Frames（获取任务结果）
      • Veo3（文字生成视频）
      • Veo3（获取任务结果）
      • Veo2（文字生成视频）
      • Veo2-i2v（图片生成视频）
      • Veo2（获取任务结果）
    • 昆仑万维
      • Skyreels（图片生成视频）
      • Skyreels（获取任务结果）
    • Higgsfield
      • Generate（图片生成视频）
      • Shortads（图片生成广告视频）
      • Fetch（获取任务结果）
    • 蝉镜数字人
      • 创建视频合成任务
      • 获取视频详情
      • 视频删除
      • 获取支持的字体列表
      • 生成数字人形象
      • 拉取形象详情
      • 删除形象
      • 公共数字人列表
    • Midjourney
      • MJ-Video（图片生成视频）
      • MJ-Video（视频延长）
      • Fetch（获取任务）
    • Topview
      • 营销数字人
        • 提交Avatar Marketing Video
          POST
        • 获取Avatar Marketing Video结果
          GET
        • 获取脚本列表
          GET
        • 修改脚本内容
          POST
      • 普通数字人
        • VideoAvatar 提交
        • VideoAvatar 查询
        • 制定私有数字人
        • 查询私有数字人
        • 删除私有数字人
        • 查询公共数字人
        • 查询公共音色
        • 查询字幕样式接口
      • 商品数字人
        • Product ImageReplace 提交
        • Product ImageReplace 查询
        • Product Image2Video 提交
        • Product Image2Video 查询
        • 查询公共数字人
        • 查询商品类别
      • 商品图替换
        • productAnyShoot ReplaceImage 提交
        • productAnyShoot ReplaceImage 查询
        • 查询模板列表
        • 查询模板分类
      • 图生视频
        • 提交Image2video（图生视频）
        • 查询Image2video（图生视频）
      • 上传接口
        POST
  • 音视频处理
    • 统一接口
      • TTS
        • 文本生成语音
        • 查询TTS供应商信息
    • 302.AI
      • Stable-Audio（纯音乐生成）
      • Transcript（音视频转字幕）
      • Transcriptions（语音转文字）
      • Alignments（字幕打轴）
      • WhisperX（语音转文字）
      • F5-TTS （文字转语音）
      • F5-TTS （异步文字转语音）
      • F5-TTS （异步获取结果）
      • mmaudio（文字生成配音）
      • mmaudio（视频AI配音）
      • mmaudio （异步获取结果）
      • Diffrhythm（歌曲生成）
    • OpenAI
      • Speech（文字转语音）
      • Transcriptions（语音转文字）
      • Translations（语音翻译英文）
      • Realtime（实时语音对话）
    • Azure
      • AzureTTS（微软云文字转语音）
      • Voice-List（声音列表）
    • Suno
      • Music（Suno全自动模式）
      • Music（Suno自定义模式）
      • Music（Suno生成歌词）
      • Music（Suno歌曲续写）
      • Fetch（Suno查询任务）
      • 上传音乐
      • 歌曲拼接
      • 新建 Persona
      • 声曲分离
    • 豆包
      • tts_hd（文字转语音）
      • vc（音视频字幕生成）
      • fetch（查询音视频字幕结果）
      • vc-ata（自动字幕打轴）
      • fetch（查询字幕打轴结果）
    • Fish Audio
      • TTS（文字转声音）
      • Model（创建声音模型）
      • Model（获取声音模型）
      • Model（删除声音模型）
      • Model（更新声音模型）
      • Model（获取声音列表）
    • Minimax
      • T2A（语音生成-同步）
      • T2A（语音生成-异步）
      • T2A（语音生成-状态查询）
      • T2V（文生音色）
      • Files（音频文件下载）
      • Music-Upload（上传原音乐）
      • Music-Generation（生成新音乐）
    • Dubbingx
      • TTS（文字转语音）
      • GetTTSList（获取音色列表）
      • GetTTSTask（获取任务状态）
      • Analyze（分析情绪）
    • Udio
      • Generate（生成音乐）
      • Generate（音乐续写）
      • Query（查询任务）
    • Elevenlabs
      • 302格式
        • Speech-to-text（语音转文字）
        • Speech-to-text（异步获取结果）
        • TTS-Multilingual-v2（文字转语音同步）
        • TTS-Multilingual-v2（文字转语音异步）
        • TTS-Multilingual-v2（异步获取结果）
        • TTS-Flash-v2.5（文字转语音同步）
        • TTS-Flash-v2.5（文字转语音异步）
        • TTS-Flash-v2.5（异步获取结果）
      • 官方格式
        • Speech-to-text（语音转文字）
        • Text-to-speech（文字转语音）
        • Models（获取模型）
        • Voices（获取声音）
    • Mureka
      • 上传音乐
      • 根据提示生成歌词
      • 继续从现有歌词写歌词
      • 根据歌词生成歌曲
      • 获取生成的歌曲
      • 分离音乐的音轨
      • 生成纯音乐曲目
      • 获取纯音乐曲目
      • 文字转语音
      • 创建播客音频
    • 硅基流动
      • 上传参考音频
      • 删除参考音频
      • 创建语音转文本请求
      • 创建文本转语音请求
    • Google
      • Text-to-Speech
      • gemini-2.5-flash-preview-tts
      • gemini-2.5-pro-preview-tts
    • 蝉镜数字人
      • 创建语言生成任务
      • 获取语音合成结果
      • 创建声音定制任务
      • 获取声音定制结果
      • 删除定制声音
    • Mistral
      • Transcriptions（语音转文字）
  • 信息处理
    • 统一搜索接口
      • 统一搜索接口
    • 302.AI
      • 管理后台
        • Balance（账户余额）
        • Price（获取API的价格）
        • 获取用户 API Keys 列表数据
        • 获取指定 API Key 的数据
        • 创建 API Key
        • 更新 API Key
        • 删除 API Key
      • 信息搜索
        • Xiaohongshu_Search（小红书搜索笔记）
        • Xiaohongshu_Search（小红书搜索笔记V2）
        • Xiaohongshu_Search（小红书搜索笔记V3）
        • Xiaohongshu_Note（小红书获取笔记）
        • Xiaohongshu_Note（小红书获取笔记V2）
        • Xiaohongshu_Note（小红书获取笔记V3）
        • Xiaohongshu_Comments（小红书获取笔记评论）
        • Tiktok_Search（Tiktok搜索视频）
        • Douyin_Search（抖音搜索视频）
        • Twitter_Search（X搜索内容）
        • Twitter_Post（X获取用户帖子）
        • Twitter_User（X获取用户信息）
        • Weibo_Post（微博获取用户帖子）
        • Search_Video（Youtube搜索视频）
        • Youtube_Info（Youtube获取视频信息）
        • Youtube_Subtitles（Youtube获取字幕）
        • Bilibili_Info（B站获取视频信息）
        • MP_Article_List（获取微信公众号文章列表）
        • MP_Article（获取微信公众号文章）
        • Zhihu_AI_Search（知乎AI搜索）
        • Zhihu_AI_Search（获取知乎AI搜索结果）
        • Zhihu_Hot_List（知乎热榜）
        • Video_Data（获取视频数据）
      • 文件处理
        • Parsing（文件解析）
        • Upload-File（文件上传）
        • Markitdown（文件转换为md格式）
      • 代码运行
        • 虚拟机沙盒
          • 一键运行代码
          • 创建沙盒
          • 查询自己的沙盒列表
          • 摧毁沙盒
          • 运行代码
          • 运行命令行
          • 查询指定路径下的文件信息
          • 往沙盒里导入文件数据
          • 导出沙盒文件
        • 静态沙盒
          • Run-Code（代码执行器）
      • 远程浏览器
        • 异步创建浏览器自动任务
        • 查询浏览器任务状态
        • 同步创建浏览器自动任务
      • Paper2Code
        • 创建paper2code任务（json传参）
        • 创建paper2code任务（form-data传参）
        • 查询paper2code任务
      • Paper2Poster
        • 创建paper2poster任务（json传参）
        • 创建paper2poster任务（form-data传参）
        • 查询paper2poster任务
    • Tavily
      • Search（搜索）
      • Extract（提取网页）
    • SerpApi
      • Search（搜索）
      • Search（新闻搜索）
      • Search（图片搜索）
      • Search（图搜图）
      • Search（视频搜索）
      • Search（学术搜索）
      • Search（专利搜索）
      • Search（百度搜索）
    • Search1API
      • Search（搜索）
      • News（新闻）
      • Crawl（爬取）
      • Sitemap（网站地图）
      • Trending（热门趋势）
    • Exa
      • Search（搜索）
      • Contents（获取内容）
      • Answer（回答）
    • 博查AI
      • web-search（普通搜索）
      • ai-search（AI搜索）
    • Doc2x
      • V2版本
        • PDF（上传接口-异步）
        • Status（查看处理状态）
        • Parse（请求导出文件-异步）
        • Result（获取导出结果）
      • V1版本（已废弃）
        • PDF（PDF转MD格式）
        • PDF-Async（PDF异步转换格式）
        • IMG（IMG转MD格式）
        • IMG（IMG异步转换格式）
        • Status（查看状态）
        • Export（导出文件）
    • Glif
      • Glif（Bot平台）
    • Jina
      • Reader（网页转md格式）
      • Search（网络搜索）
      • Grounding（事实求证）
      • Classify（内容分类）
    • DeepL
      • Chat（任何语言翻译为英文）
      • Chat（任何语言翻译为中文）
      • Chat（任何语言翻译为日文）
      • Translate（翻译成任何语言）
    • RSSHub
      • RSSHub（信息订阅）
    • 流光卡片
      • saveImg（卡片生成）
    • 有道
      • Youdao（有道翻译）
    • Mistral
      • OCR（PDF解析)
    • Firecrawl
      • Scrape（页面抓取）
      • Batch Scrape（批量抓取）
      • Scrape Status（获取结果）
      • Scrape Errors（获取错误）
      • Map（网站地图）
      • Search（搜索）
  • RAG相关
    • OpenAI
      • Embeddings（向量生成）
    • Jina
      • Embeddings（向量生成）
      • Rerank（重排序）
      • Rerank（多模态重排序）
      • Tokenizer（文本切片）
    • 国产模型
      • Embeddings（智谱）
      • Embeddings（智源BAAI）
      • Embeddings（百川）
      • Embeddings（有道）
      • Rerank（有道）
      • Rerank（智源BAAI）
    • 302.AI
      • Chat（知识库对话）
      • Chat（OpenAI兼容格式）
      • Create（创建知识库）
      • Delete（删除知识库）
      • Upload（上传文件到知识库）
      • Delete（删除知识库的指定文件）
      • List（获取知识库列表）
      • Info（获取知识库详情）
      • Meta-Chunking（文本LLM切片）
      • Meta-Chunking（文件LLM切片）
    • 硅基流动
      • Embeddings
      • Rerank
    • Google
      • Embeddings（向量生成）
  • 工具API
    • AI Agent
      • Agent SSE响应接口
      • 查询任务状态
      • 创建OWL沙盒任务
    • AI视频素材创意站
      • Scripts（生成视频素材文案）
      • Terms（生成视频素材搜索词）
      • Videos（创建视频素材生成任务）
      • Tasks（获取视频任务进度）
    • AI论文写作
      • CO-STORM
        • 创建生成文章任务
        • 继续生成对话接口
        • 更新文章内容接口
        • 获取文章信息
      • 异步生成论文
      • 获取论文结果
    • AI播客制作
      • 异步生成播客文本
      • 查询生成播客文本任务状态
      • 异步生成播客音频
      • 查询生成播客音频任务状态
      • 获取支持的音色信息
    • AI文案助手
      • 获取工具列表
      • 生成文案
    • AI视频深度翻译
      • 查询视频信息
      • 视频下载
      • 分离视频音轨
      • 音频人声分离与转录
      • 字幕精细翻译
      • 视频烧录
      • 原声克隆
      • 查询任务状态
      • 获取视频链接指定帧
    • AI文档编辑器
      • 生成长文大纲
      • 生成文章内容
    • 网页数据提取工具
      • 生成Schema
      • 创建提取任务
      • 查询提取进度
    • AI提示词专家
      • 提示词优化
      • 图片提示词生成
      • 创建spo提示词优化任务
      • 查询spo提示词优化结果
    • AI 3D建模
      • 3D模型文件类型转换
    • AI搜索大师3.0
      • AI搜索
    • AI矢量图生成
      • SVG转视频
    • AI答题机
      • 答题
    • AI PPT制作
      • AI PPT接口使用说明
      • 一键生成PPT接口
      • 文件解析
      • 生成大纲
      • 生成大纲内容
      • 获取模板选项
      • 生成PPT接口（同步接口）
      • 加载PPT数据
      • 生成PPT接口（异步接口）
      • 异步查询生成PPT状态
      • 下载PPT
      • 新增/更新自定义PPT模板
      • 分页查询 PPT 模板
    • AI学术论文搜索
      • arxiv论文搜索
      • 谷歌论文搜索
    • 网站一键部署
      • 2025.5.15 新增md格式支持（md自动转换成html）
      • 创建托管网页（form表单传参接口）
      • 创建托管网页（json传参接口）
      • 创建托管网页（二进制传参接口）
      • 查询API Key下的托管项目列表
      • 删除部署了的网页
    • AI头像制作
      • 生成头像(json传参示例)
      • 生成头像(form-data传参示例)
    • AI卡片生成
      • 生成知识卡片
      • 生成海报
      • 生成哲理卡片
      • 生成哲学引用语录
    • AI图像创意站
      • 生成创意图像的接口使用说明
      • 获取模板列表
      • 生成创意图片
  • 帮助中心
    • HTTP状态码及其含义
    • 图片翻译支持语言
    • 有道翻译支持语言
  1. 营销数字人

提交Avatar Marketing Video

正式环境
https://api.302.ai
正式环境
https://api.302.ai
POST
https://api.302.ai
/topview/v1/m2v/task/submit
Avatar Marketing Video是Topview的产品营销视频生成工具，用户上传产品图片、脚本或素材，就能一键生成穿戴或互动演示产品，支持多种语言。
演示视频
价格：2 PTC/次
如果同时传入 productLink 和 fileIds 参数，将忽略 fileIds 参数，默认使用从 productLink 解析出的所有视频和图片。
该接口为异步接口提交成功后，将返回ID，用户可通过获取 Marketing video 结果接口查询处理结果。

请求参数

Header 参数
Authorization
string 
可选
示例值:
Bearer {{YOUR_API_KEY}}
Body 参数application/json
productLink
string 
可选
fileIds
array[string]
必需
视频或者图片，通过上传接口上传后获取fileId。
productName
string 
必需
可从产品链接自动解析。当 productLink 为空时必填。
productDescription
string 
必需
可从产品链接自动解析。当 productLink 为空且 isDiyScript=false 时必填。
aspectRatio
string 
可选
默认值：9:16。可选值：9:16、3:4、1:1、4:3、16:9
language
string 
可选
Default value: en
Language list:
English: en
Arabic (العربية): ar
Bulgarian (Български): bg
Croatian (Hrvatski): hr
Czech (Čeština): cs
Danish (Dansk): da
Dutch (Nederlands): nl
Filipino (Filipino): fil
Finnish (Suomi): fi
French (Français): fr
German (Deutsch): de
Greek (Ελληνικά): el
Hindi (हिन्दी): hi
Hungarian (Magyar): hu
Indonesian (Bahasa Indonesia): id
Italian (Italiano): it
Japanese (日本語): ja
Korean (한국어): ko
Malay (Bahasa Melayu): ms
Norwegian (Norsk): nb
Polish (Polski): pl
Portuguese (Português): pt
Romanian (Română): ro
Russian (Русский): ru
Simplified Chinese (简体中文): zh-CN
Slovak (Slovenčina): sk
Spanish (Español): es
Swedish (Svenska): sv
Traditional Chinese (繁體中文): zh-Hant
Turkish (Türkçe): tr
Ukrainian (Українська): uk
Vietnamese (Tiếng Việt): vi
Thai (ภาษาไทย): th. Currently, the supported voiceIds for Thai are: 5d188a658b5a424e98bf0dbbcb8f97d8, eea5e5a4fb534231a5b4cf4766dd7a5f, 537e2643719c47bdac1d8a2c7f0c844a, e22db502aa8d40d9ba791083c9f4ab35
videoLengthType
integer 
可选
默认值：1. 1：30-50秒；2：15-30秒；3：30-45秒；4：45-60秒
endcardFileId
string 
可选
通过上传接口上传后获取。
endcardAspectRatio
string 
可选
默认值：all。可选值：all、9:16、3:4、1:1、4:3、16:9
endcardBackgroundColor
string 
可选
Default value: black. Optional values: black, white
isDiyScript
boolean 
可选
是否使用自定义脚本。True - 使用自定义脚本，默认 false
diyScriptDescription
string 
可选
自定义脚本内容，仅当isDiyScript=true时生效
示例
{
    "fileIds": [
        "8d745437254941adb141f95836d9454c"
    ],
    "productName": "8d745437254941adb141f95836d9454c.mp4",
    "productDescription": "303 talk"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.302.ai/topview/v1/m2v/task/submit' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "fileIds": [
        "8d745437254941adb141f95836d9454c"
    ],
    "productName": "8d745437254941adb141f95836d9454c.mp4",
    "productDescription": "303 talk"
}'

返回响应

🟢200成功
application/json
Body
code
string 
必需
message
string 
必需
result
object 
必需
taskId
string 
必需
使用这个taskId去查询
status
string 
必需
errorMsg
null 
必需
subTaskId
string 
必需
示例
{"code":"200","message":"Success","result":{"taskId":"f58e38c01cdc497d9c6d05fbf54fef4e","status":"success","errorMsg":null,"subTaskId":"f58e38c01cdc497d9c6d05fbf54fef4e"}}
修改于 2025-07-12 20:24:03
上一页
Fetch（获取任务）
下一页
获取Avatar Marketing Video结果
Built with