Pika API：官方开发者站、两层计费与调用三跳

Pika 确实有官方 API，而且它跑在一个独立域名上：dev.pika.art，另一个官方入口是 mcp.pika.art。开发者站与消费端的 pika.art 是两套独立系统、两套独立计费，而搜这个词返回的结果，大多被转售方的文档占据。

官方 Pika API 是什么，入口在哪

Pika 把开通方式写得很直白：The API is self-serve — sign in, create an API key, and you get access to every Pika model listed above along with a quickstart guide.

API key 在 dev.pika.art/keys 创建，客户调用基址是 https://api.dev.pika.art，规格索引是 dev.pika.art/llms.txt，另有一份 OpenAPI 3.1 描述放在 dev.pika.art/openapi.json。登录、密钥、Webhook、模型目录的深链分别是 dev.pika.art/login、dev.pika.art/keys、dev.pika.art/webhooks、dev.pika.art/models。模型层面的情况见 Pika 主题页。

开发者站的定位句是 Introducing the Pika API Club，官方把它定义成 a membership program that provides access to top gen media models at previously impossible prices, all through one API。

有一页过期内容会误导人：消费端 FAQ 至今仍用 We're taking on select partners. Interested? Learn more and apply here: https://pika.art/api 来回答 API 问题，那是一句申请制措辞；而那个链接现在打开的，正是自助开通的 Pika API Club 页面。这一页的滞后不止一处，它的模型段落写的还是 Pika 2.2, our latest model，而定价页与开发者站早已是 Pika 2.5。

开发者站上的两层计费

dev.pika.art 会收两笔钱，而且两笔是分开的。

第一层：会员费

官方原话是 Membership is $10/month and unlocks member (wholesale) pricing. 新会员还会拿到首月用量的抵扣额度，而 mcp.pika.art 通篇没有提到这笔会员费。官方给这笔费用的解释是，它换来的是议价能力：The membership fee is what allows Pika to negotiate better rates on your behalf and pass genuine wholesale pricing to our members rather than baking a hidden markup into every API call. 官方也自己承认边界：we can't guarantee we're going to be the cheapest on every single model。

第二层：按量付费

会员费之外，官方写的是 model usage is pay-as-you-go. You only pay for what you actually generate, at member rates. Pika 自家模型在开发者站上的标价如下：

先看单位，再看数字：视频类按秒计费，Pikaffects、Pikadditions、Pikaswaps 按次计费，更大的目录里还有按张与按 1M token 计费。官方 FAQ 给的是区间：Most models are $0.04/sec at 720p and $0.06/sec at 1080p，每月超过 10,000 秒后自动进入阶梯折扣。首页另有一张官方自己做的竞品比价表，口径写得很清楚：Prices recorded as of 8.23.26. Includes 5% platform fee.，引用时必须把这句话带上。

这些账目和 pika.art 不共用同一个钱包：消费端套餐从 Basic 的 $0 到 Fancy 的 $76 一个月，扣的是 video credits；API 侧则用 micro_usd 计价，除以 1,000,000 才是美元。两套刻度之间的换算，官方没有公布。

鉴权：把 API key 放在请求头里

每次调用都要在请求头里带 key，官方规格写明两种写法：X-API-Key: $PIKA_API_KEY or Authorization: Bearer $PIKA_API_KEY. Google's x-goog-api-key is not accepted.

最后那句，是从 Google 生态迁过来的开发者撞上的第一堵墙。官方的 onboarding prompt 把安全规则也写死了：Never ask me to paste it into chat, expose it in browser code, or commit it. 官方在 dev.pika.art/agent 上还给了六个一键投喂入口：Send to Claude Code、Send to Codex、Send to Cursor、Send to Lovable、Send to Replit、Send to ChatGPT。

目录类接口里，有几个完全不需要 key，例如 GET /catalog/apis 与 POST /catalog/apis/{api_id}/quote。同一套 API 还提供计费查询（GET /billing/balance、GET /billing/spend/daily）、Webhook 投递记录（GET /v1/webhooks/deliveries），以及走 OpenAI 兼容形态的 POST /v1/chat/completions。

调用三跳：提交、轮询、取件

官方给出的调用约定就三步：1. POST /v1/media/{api_id} with that model's JSON body 2. Poll GET /v1/media/jobs/{request_id} until status == "completed" 3. Fetch GET /v1/media/jobs/{request_id}/content for the result url。

# 第一步：为 Pika 2.5 提交一个图生视频任务。
# JSON 请求体由模型自己定义：先去取它的规格，再发出去。
# 规格：https://dev.pika.art/llms/pika/pika-2.5/image-to-video
curl -X POST https://api.dev.pika.art/v1/media/pika/pika-2.5/image-to-video \
  -H "X-API-Key: ${PIKA_API_KEY}" \
  -H "Content-Type: application/json" \
  -d @pika-2.5-image-to-video.json

返回的就是任务对象，轮询只需要盯住其中两个字段：

{
  "request_id": "req_xxxxxxxx",
  "status": "completed"
}

# 第二、三步：轮询任务状态，然后取出结果链接。
JOB_ID=req_xxxxxxxx        # 来自提交响应的 request_id

until [ "$(curl -s "https://api.dev.pika.art/v1/media/jobs/${JOB_ID}" \
    -H "X-API-Key: ${PIKA_API_KEY}" | jq -r .status)" = "completed" ]; do
  sleep 5
done

curl -s "https://api.dev.pika.art/v1/media/jobs/${JOB_ID}/content" \
  -H "X-API-Key: ${PIKA_API_KEY}" | jq .

上传走的是预签名 URL，valid for 5 minutes；content_type 不支持会返回 415，超过体积上限（20 MB image and audio, 50 MB video）会返回 413。至于取件链接本身能存活多久，官方没有公布，所以别把链接当存储用。任务跑完想清理，用 DELETE /v1/media/jobs/{request_id}。官方另外特别强调，别猜端点、字段、模型支持和价格（Do not guess endpoints, fields, model support, or pricing.），规格一律去 llms.txt 里逐条取。

用 Pikaframes 路径做首尾帧生成

Pikaframes 是消费端的功能名，API 侧同一个能力叫 Pika 2.5 Keyframe，路径是 /models/pika/pikaframes/image-to-video，api_id 是 pika/pikaframes/image-to-video。两张图都要先走上传接口，所以两个预签名 URL 都得在五分钟内用掉。

# Pikaframes：还是三跳，只是换了一个 api_id。
curl -X POST https://api.dev.pika.art/v1/media/pika/pikaframes/image-to-video \
  -H "X-API-Key: ${PIKA_API_KEY}" \
  -H "Content-Type: application/json" \
  -d @pika-pikaframes.json

同一个能力在界面上的操作，见 Pika 实操教程。消费端把 Pikaframes 的时长档做到很长，但接口侧的时长与分辨率档位要以官方规格为准，本文不替官方补数字。

api_id 书写纪律与聚合器目录

Send the slashes in api_id literally —— pika/pika-2.5/image-to-video 是路径，不是产品版本号。当 agent 页面与规格索引写得不一样时，以 dev.pika.art/llms.txt 为准。

目录比名字大得多：官方索引写着 155 callable operations，覆盖 100+ 个模型，来自 Pika、ByteDance、Google、OpenAI、Kling、Alibaba、Anthropic、Black Forest Labs、DeepSeek、ElevenLabs、Ideogram、Meta、MiniMax、Recraft 等厂商。官方给 agent 的默认风控甚至写着 When the user asks for a video, default to seedance-2.0 at 720p, 5s. Always confirm the model and resolution before spending more than 100 credits. —— 官方自己给文生视频推荐的起点里并没有 Pika 2.5，排在最前的是 Seedance 与 MiniMax，那条线见 Seedance 主题页。

官方没有公布的内容

下面几项数字，采购评审一定会问，但官方页面上一律找不到：

• 逐模型的完整 API 价目；dev.pika.art/pricing 是一个客户端计算器。
• 单个任务的预计耗时、超时阈值与任务保留时长。
• 企业档的并发数字；官方只公布默认值 60 requests per minute and 10 concurrent jobs，企业档只有 Volume pricing（up to 70% off）与 Higher Concurrency 这类条目名。
• 官方 SDK、quote 接口的返回字段，以及 Pika 2.5 的技术参数（架构、参数量、推理硬件一律未公布）。

企业档页面另外给了三个数字可以引用：99.9% Uptime、100+ Models、1 API integration。

常见问题

Pika API 是官方的吗，谁都能开通吗？ 是官方的，域名挂在 Pika 自己名下；开通是自助的；只有消费端 FAQ 还在讲申请制。

要先交月费才能调用吗？ dev.pika.art 写的是 $10/month 会员费；mcp.pika.art 把同一套 API 称作自助开通，通篇没提会员费。

一次图生视频要花多少钱？ Pika 2.5 的标价是 from $0.04 / sec，官方 FAQ 给的区间是 $0.04/sec at 720p and $0.06/sec at 1080p。

生成结果能商用吗？ API 输出是 licensed for commercial use under your Pika API agreement；消费端 Basic、Standard 套餐的内容不能商用，两套授权之间的关系官方没有说明。

有官方 SDK 吗，一个任务要跑多久？ 两者都没有公布 —— 自己轮询 status，自己设超时。官方只给了支持口径：非紧急问题发 api@pika.art，通常一个工作日内回复，每个 API 客户还配一个共享 Slack 频道。

开工前先定三件事：官方域名、适用你的是哪一层计费，以及精确的 api_id。

发布于

2026年9月14日

信息核验

2026年9月14日

作者

AI Tool Blog 编辑部