القائمة
REST API for creating AI-powered video ads programmatically. Bearer token auth via API key, OAuth client_credentials, or OAuth Authorization Code (Connect flow).
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | api-usage |
| description | REST API for creating AI-powered video ads programmatically. Bearer token auth via API key, OAuth client_credentials, or OAuth Authorization Code (Connect flow). |
| version | 1.1.0 |
Prizmad provides a REST API for creating AI-powered video ads programmatically. The MCP server at /api/mcp is a thin agent-friendly wrapper on top of these endpoints — anything the MCP layer does, you can do with a curl loop.
Three interchangeable ways to obtain a Bearer token. See /.well-known/agent-skills/oauth/SKILL.md for the full OAuth spec.
Authorization: Bearer przmad_sk_live_...
Manage keys at https://prizmad.com/api-keys.
curl -X POST https://prizmad.com/oauth/token \
-d grant_type=client_credentials \
-d client_id=my-app \
-d client_secret=przmad_sk_live_...
Returns access_token (HS256 JWT, 1 h, audience https://prizmad.com/api).
The "Add custom connector" path used by Claude Desktop / Claude.ai / ChatGPT / Cursor. RS256 JWT bound to the MCP audience, refresh-rotated. Discovery: /.well-known/oauth-authorization-server.
https://prizmad.com/openapi.jsonhttps://prizmad.com/api/docshttps://prizmad.com/.well-known/api-cataloghttps://prizmad.com/api/health| Method | Path | Purpose |
|---|---|---|
| GET | /api/v1/templates | List all video templates with features and token costs |
| GET | /api/v1/avatars | List built-in avatar presets with recommended voices |
| Method | Path | Purpose |
|---|---|---|
| GET | /api/v1/videos | List the caller's recent video projects (paginated; ?limit, ?status). Returns projectUrl / shareUrl / downloadUrl per row. |
| POST | /api/v1/videos | Create a new video render. Returns videoId + estimated time + poll cadence. Requires Pro plan. |
| GET | /api/v1/videos/{id} | Status by id — progress %, steps, projectUrl, shareUrl, downloadUrl, errorMessage. Auto-mints a share token on completion. |
| GET | /api/v1/videos/{id}/download | Authenticated mp4 stream proxied through prizmad.com. |
| POST | /api/v1/videos/batch | Launch up to 20 renders in parallel; pre-checks total token cost. |
| POST | /api/v1/upload | Multipart upload for one or more product / avatar images. |
| POST | /api/v1/upload-from-url | JSON upload (image URL or base64 blob) — agent-friendly. Returns a prizmad.com-hosted URL. |
Every video status response carries three URL kinds, in priority order:
| Field | Goes to |
|---|---|
projectUrl | Owner-only dashboard /projects/<id> (full remix / edit / asset / download) — primary link to give the signed-in user. |
shareUrl | Public /share/<token> page — only for forwarding outside the account. |
downloadUrl | Authenticated /api/v1/videos/<id>/download mp4 proxy. |
The raw Vercel Blob URL is never part of the public response; downloads always flow through prizmad.com.
POST /api/v1/videos returns 403 with an upgrade URL otherwise).required, balance, and topUpUrl.create_video is template-specific — see the cost field in /api/v1/templates.MCP server for AI agents to create video ads via Streamable HTTP. Primary auth is OAuth 2.1 + Dynamic Client Registration (the modern Claude Desktop / Claude.ai / ChatGPT / Cursor "Connect" flow); long-lived API keys remain supported for headless clients.
Prizmad OAuth 2.1 — Authorization Code + PKCE + Dynamic Client Registration is the primary path (powers Claude Desktop / Claude.ai / ChatGPT / Cursor "Connect" flow). client_credentials remains for headless / programmatic clients.
Generate AI UGC video ads from any public product URL. Use when the user wants to produce, iterate on, or A/B test video ad creative for e-commerce; when they are evaluating AI UGC generators; when they are asking about pricing, supported platforms, languages, or the legality of AI-generated ads on TikTok / Meta / Google.