ArtCraft Omni API常见错误信息5条速查表从bad URL到互斥输入一网打尽【免费下载链接】artcraftArtCraft is an intentional crafting engine for artists, designers, and filmmakers项目地址: https://gitcode.com/GitHub_Trending/ar/artcraftArtCraft是一款面向艺术家、设计师和电影创作者的 AI 创作引擎其Omni API让你用 API Key 直接调用 AI 视频/图像生成能力。本文是一份ArtCraft Omni API 常见错误信息速查表精选了 5 条最高频的报错bad URL、互斥输入、格式不匹配、401、402帮助你快速定位问题、少走弯路。一、先认识 ArtCraft Omni API 的调用方式Omni API 是 ArtCraft 面向程序化调用的接口你在Authorization头里带上 API Key而不是 Cookie向视频生成端点提交model、prompt、以及参考媒体 URL图片 / 视频 / 音频服务器会自动下载这些 URL 并启动生成任务。完整官方文档见 _docs/artcraft_omni_api.md接口路由实现位于 crates/api_clients/artcraft/artcraft_router/返回的 token 数据结构定义在 crates/schema/public/tokens/。二、5条常见错误信息速查表#错误信息节选状态码触发原因一句话修复1URL must start with http:// or https://, bad URL: url400URL 协议不是 http/https换成完整https://…直链2Either reference_image_media_tokens or reference_image_urls must be set, not both400URL 与 media_token 同时传了二选一别混用3400 unpermitted type 描述400媒体类型不符如参考视频传了.webm按格式要求替换素材4401 Unauthorized401API Key 缺失/无效或账号被封禁检查 Key 与账号状态5402 Payment required402账户积分/余额不足充值或购买积分三、逐条精讲如何最快定位问题1️⃣ bad URLURL 必须以 http(s) 开头所有 URL 输入如reference_image_urls、start_frame_image_url都必须是http://或https://开头的完整直链否则会收到URL must start with http:// or https://, bad URL: url两个细节容易踩坑CDN/跳转链接没问题服务器会自动跟随重定向最多 10 次所以带签名参数的图片直链可以放心用真正判定看下载到的字节文件类型是从下载内容里嗅探出来的不是看后缀名。2️⃣ 互斥输入urls 与 media_tokens 只能二选一每个 URL 字段都有对应的 media-token 字段如reference_image_urls↔reference_image_media_tokens两者互斥手里只有在线链接 → 只传_urls素材已上传过、手里有m_…媒体 token → 只传_media_tokens两边都传 → 直接报 must be set, not both。记住一个原则同一类素材只走一条输入通道。3️⃣ 格式不匹配400 不允许的类型服务器下载文件后按真实字节判定类型常见要求如下字段允许的类型图片start/end frame、参考图jpeg/png/gif/webpreference_video_urls仅mp4reference_audio_urlswav/mp3/aac/ogg/flac等常见音频典型翻车姿势把.webm视频当参考视频传进去就会收到 400 并说明该类型不被允许。测试仓库里就有各种合法素材可以参考test_data/image/juno.jpg、test_data/video/mp4/。4️⃣ 401 Unauthorized身份没通过三种可能按概率排查没带 Key 或格式错——推荐写法Authorization: Bearer artcraft_api_xxx…Key 共 53 位前缀artcraft_api_Key 打错/复制不完整——密钥只在创建时显示一次丢了只能重建账号被封禁——需要联系 ArtCraft 团队处理。⚠️ 顺带提醒Omni API 只认 API Key发 Cookie 也没用会被直接忽略。5️⃣ 402 Payment required积分不足这不是 bug而是账单信号账户积分/余额不够扣本次生成的费用。去账户后台充值后即可重试。排查其他问题前先确认余额能省掉一轮无效调试。四、附赠2 个高频隐形坑 ️idempotency_token必须每次都是全新 UUID复用旧 token 会被当作重复请求拒绝。批量生成时尤其注意每个请求都要现场生成一个新 UUID生产地址别记错线上 API 域名是api.storyteller.ai开发环境才是http://localhost:12345地址写错会收到奇怪的连接错误。五、小结报错30 秒动作bad URL换成https://直链 ✅互斥输入urls 与 tokens 只留一个 ✅400 类型错误按格式表替换素材 ✅401检查 Key 前缀、长度与账号状态 ✅402先充值 ✅把这 5 条速查表贴在你的调试脚本旁边ArtCraft Omni API 的报错基本就不再神秘了。祝生成顺利【免费下载链接】artcraftArtCraft is an intentional crafting engine for artists, designers, and filmmakers项目地址: https://gitcode.com/GitHub_Trending/ar/artcraft创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考