如何用代码调用ArtCraft Omni APIAPI Key驱动AI视频生成的完全指南【免费下载链接】artcraftArtCraft is an intentional crafting engine for artists, designers, and filmmakers项目地址: https://gitcode.com/gh_mirrors/ar/artcraftArtCraft 是面向艺术家、设计师和电影创作者的 AI 创作引擎The IDE for artists。通过它的ArtCraft Omni API你只需用一个API Key进行认证就能以编程方式调用 AI 视频生成传入图片、视频、音频的 URL 参考素材和一段提示词服务器自动完成下载并生成视频再轮询任务状态拿到成品 mp4 链接。本指南带你从零开始用 3 步完成第一次 AI 视频生成。1 分钟看懂 Omni API 是什么ArtCraft 桌面/网页应用里的Omni Gen生成功能在 API 侧对应就是Omni API——它镜像了应用内的生成接口但专为程序化调用设计对比项应用内Omni GenOmni API认证方式浏览器会话 CookieAuthorization请求头中的 API Key调用方式点击界面按钮HTTP 请求curl / Python / JS 均可素材来源本地上传直接传http(s)素材 URL服务器代下载两个关键环境地址开发环境http://localhost:12345生产环境https://api.storyteller.ai ArtCraft 的强项正是素材驱动的创作图生视频、3D 场景合成、角色身份保持等见 README.mdOmni API 把这套能力开放给了你的代码。第 1 步获取你的 ArtCraft API Key登录 ArtCraft 网页应用进入Account → Settings → API Keys创建 Key 并立即复制——密钥只显示一次请妥善保管Key 的固定格式为artcraft_api_前缀 40 位随机字符共 53 个字符例如artcraft_api_3k7q9w0xv2hs5n8m4d6r1t8y0p2s4f6h8j0k2m4n6⚠️ 像保管密码一样保管它不要提交到代码仓库也不要写进日志。若看不到 API Keys 入口说明你的账户尚未开启该权限。API Key 的管理数据结构可在 api_keys 模块中找到。第 2 步用 Bearer Token 认证请求所有请求都通过Authorization头携带密钥不要附带任何 CookieCookie 会被忽略。三种写法均有效推荐BearerAuthorization: Bearer artcraft_api_你的密钥第 3 步发起第一次 AI 视频生成请求核心端点是POST /v1/omni_api/generate/video。完整请求体字段定义见 omni_api_video_generate_request.rs常用参数如下参数说明model生成模型必填如seedance_2p0prompt文本提示词duration_seconds视频时长秒如6aspect_ratio画幅如wide_sixteen_by_nine、squareidempotency_token必填每次请求生成一个新的 UUID防止重复提交start_frame_image_url起始关键帧图片 URLreference_image_urls参考图片 URL 数组reference_video_urls/reference_audio_urls参考视频mp4/ 音频 URL 数组图真实照片可作为起始帧/参考图素材直接以 URL 传给 API。最快上手一条 curl 命令把YOUR_API_KEY换成你的密钥start_frame_image_url换成任意图片地址curl -s -X POST http://localhost:12345/v1/omni_api/generate/video \ -H Authorization: Bearer YOUR_API_KEY \ -H Content-Type: application/json \ -d { model: seedance_2p0, prompt: 一只狗站在湖畔木栈桥上微风吹动它的毛发湖面泛起涟漪, duration_seconds: 6, aspect_ratio: wide_sixteen_by_nine, idempotency_token: $(uuidgen), start_frame_image_url: https://example.com/puppy.jpg }成功后返回{ success: true, inference_job_token: jinf_xxxxxxxxxxxxxxxxxxxxxxxxx, all_job_tokens: [jinf_xxxxxxxxxxxxxxxxxxxxxxxxx] }拿到inference_job_token后视频才真正开始生成。轮询任务状态获取生成的视频生成是异步的。用下面这个端点轮询直到状态进入终态单个任务GET /v1/omni_api/job_status/job/{token}批量任务GET /v1/omni_api/job_status/batch?tokensjinf_aaatokensjinf_bbb响应结构定义见 omni_api_job_status_payload.rs三个要点state.status.statuspending、started、attempt_failed时继续轮询complete_success、complete_failure、dead、cancelled_by_user、cancelled_by_system为终态state.status.progress_percentage0–100 的进度值方便展示进度条state.maybe_result.media_links.cdn_url任务成功后这就是成品.mp4的可播放/可下载地址——这是你最想要的字段。一段 Python 轮询示例每 5 秒查一次import time, uuid, requests BASE_URL http://localhost:12345 # 生产环境: https://api.storyteller.ai API_KEY YOUR_API_KEY TERMINAL_FAILURES {complete_failure, dead, cancelled_by_user, cancelled_by_system} while True: resp requests.get( f{BASE_URL}/v1/omni_api/job_status/job/{JOB_TOKEN}, headers{Authorization: fBearer {API_KEY}}, timeout30, ) state resp.json()[state] status state[status][status] print(status, state[status][progress_percentage], %) if status complete_success: print(视频地址:, state[maybe_result][media_links][cdn_url]) break if status in TERMINAL_FAILURES: print(任务未产出结果:, status) break time.sleep(5)常见错误排查清单现象原因与处理401 UnauthorizedAPI Key 缺失、无效或账户被禁用402 Payment required账户积分/余额不足Either … must be set, not bothURL 字段与 media-token 字段互斥只能二选一URL must start with http:// or https://素材 URL 协议不合法400类型不符如把.webm当作参考视频传入参考视频必须是mp4重复 token 被拒每次请求都要使用全新的idempotency_token 其他小贴士素材 URL 会跟随最多 10 次重定向CDN 地址可以直接用文件类型由下载后的字节内容检测图片支持jpeg/png/gif/webp音频支持wav/mp3/aac/ogg/flac等图像生成有对应端点POST /v1/omni_api/generate/image规则相同。参考资料官方 API 指南本指南的完整版_docs/artcraft_omni_api.md请求结构定义crates/api_clients/artcraft/artcraft_api_defs/src/omni_api/客户端配方上传/下载媒体文件crates/api_clients/artcraft/artcraft_client/src/recipes/开发环境搭建_docs/dev_setup.md至此你已经掌握了用 API Key 驱动 ArtCraft 生成 AI 视频的完整链路建 Key → Bearer 认证 → 提交生成 → 轮询取结果。把这段代码嵌入你的工作流就可以批量、自动化地生产视频内容了。【免费下载链接】artcraftArtCraft is an intentional crafting engine for artists, designers, and filmmakers项目地址: https://gitcode.com/gh_mirrors/ar/artcraft创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考