Cliprise Business API

Full catalog (45 models), generate and status/download endpoints, API credits from modelListAPI.json. English reference.

Overview

The Cliprise Business API lets server-side clients start AI media jobs (generate) and inspect or download results (status), using a single catalog of model identifiers.

Same for every model

• Generate — POST /app/cliprise/generate on host business.api.cliprise.app
• Auth — Authorization: Bearer <CLIPRISE_API_KEY> and Content-Type: application/json
• Body — model, callBackUrl, input (live deployment requires callBackUrl)
• Success shape — HTTP 200, often a one-element JSON array: [{"code":200,"taskId":"…"}] — parse defensively
• Status — GET /app/cliprise/status with query params; API key in query, not Bearer

Differs per model

Everything inside input: keys, types, enums. Wrong input can yield HTTP 200 with code:400 or empty bodies — see Errors and Verification.

Authentication and hosts

Generate

POST /app/cliprise/generate HTTP/1.1
Host: business.api.cliprise.app
Authorization: Bearer <YOUR_CLIPRISE_API_KEY>
Content-Type: application/json

Host gate: If Host ≠ business.api.cliprise.app, generate returns HTTP 400 with an empty body.

Status

1. Host must be business.api.cliprise.app — else {"msg":"method_not_allowed"} (400)
2. API key in query: ?apiKey=…&taskId=…&download=…

Generate endpoint

Extensions: Some routes need fields at the root and under input (e.g. runway-aleph: prompt, videoUrl; gpt-image-1: prompt, size). Top-level options may be a stringified JSON object for tier indices (seedance-v1, hailuo-2-3, wan-animate).

Success response

[{"code":200,"taskId":"f11021d5b56bc19932b336ac0dbf413f"}]

Also handle a bare object with the same fields if your client stack normalizes JSON.

Application error (HTTP 200)

{"code":400,"msg":"This field is required","data":null}

Status and download

Behaviour from workflow export apiStatusCheck.json — path cliprise/status.

Responses

Callback URL and polling

You must send a valid HTTPS callBackUrl; it is stored with the task. Completion does not always call your URL — poll status until terminal state.

Before the upstream job call, the workflow may set body.callBackUrl to an internal Cliprise webhook; your submitted URL may be persisted separately.

Errors reference

Generate

Status

See Status table above.

Models catalog (45)

Literal model string in the JSON body. Click Jump or use ?model=<id>.

Model input parameters

From the internal Cliprise model catalog. Confirm exact JSON keys per deployment where noted.

How to read catalog keys

Shared option sets

image_size (six layouts): square, square_hd, portrait_4_3, landscape_4_3, portrait_16_9, landscape_16_9 — for qwen-image, ideogram-v3, ideogram-reframe, seedream-v3.

Seedream 4.0 image_size includes portrait_2_3, landscape_3_2, etc. — seedream-v4.

Image generation

Video generation

Audio & utilities

Examples

Generate (cURL)

curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_CLIPRISE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @body.json

Example body.json:

{
  "model": "qwen-image-2",
  "callBackUrl": "https://your-service.example.com/webhooks/cliprise",
  "input": {
    "prompt": "Example",
    "image_size": "16:9",
    "output_format": "jpeg",
    "seed": 424242
  }
}

Status

curl -G "https://business.api.cliprise.app/app/cliprise/status" \
  --data-urlencode "apiKey=YOUR_KEY" \
  --data-urlencode "taskId=YOUR_TASK_ID"

Download

curl -G "https://business.api.cliprise.app/app/cliprise/status" \
  --data-urlencode "apiKey=YOUR_KEY" \
  --data-urlencode "taskId=YOUR_TASK_ID" \
  --data-urlencode "download=true" -o output.bin

Integration verification

32 models were verified: true in harness after 2026-04-04 batch; 13 remained false (empty body, wiring, or payload shape). Re-run model-api-tests after deploy and update docs.

Pricing and API credits

Credits from modelListAPI.json — each apiPricing value matches the same-index line in apiPricingDetails. The app may show a separate pricing field; this section documents apiPricing only.

veo-3-quality — Veo 3.1 Quality

qwen-image — Qwen Image

ideogram-reframe — Ideogram Reframe

nano-banana — Nano Banana

imagen-v4 — Imagen V4

runway-aleph — Runway Aleph

seedream-v4 — Seedream 4.0

kling-video-turbo — Kling 2.5 Turbo

ideogram-v3 — Ideogram V3

sora-2-turbo — Sora 2 Turbo

sora-2 — Sora 2

seedream-v3 — Seedream 3.0

veo-3-fast — Veo 3.1 Fast

wan-speech-to-video — Wan Speech To Video

flux-kontext — Flux Kontext

runway — Runway Gen4 Turbo

wan-2-5 — Wan 2.5

hailuo — Hailuo 02

kling-2-6 — Kling 2.6

seedance-1-5-pro — Seedance 1.5 Pro

elevenlabs-speech-to-text — Elevenlabs Speech To Text

nano-banana-pro — Nano Banana Pro

z-image — Z Image

seedance-v1 — Seedance V1

elevenlabs-audio-isolation — Elevenlabs Audio Isolation

flux-2 — Flux 2

gpt-image-1 — GPT Image 1

elevenlabs-tts — ElevenLabs TTS

recraft-remove-bg — Recraft Remove BG

elevenlabs-sound-effect — Elevenlabs Sound Effect

seedream-4-5 — Seedream 4.5

wan-2-2 — Wan 2.2

recraft-upscaler — Recraft Upscaler

hailuo-2-3 — Hailuo 2.3

wan-2-6 — Wan 2.6

wan-2-6-video — Wan 2.6 Video

seedance-v1-pro-fast — Seedance V1 Pro Fast

wan-animate — Wan Animate

kling-2-5 — Kling 2.5

Credits same as catalog id kling-video-turbo (API alias).

sora-story-board — Sora Story Board

kling-2-6-motion — Kling 2.6 Motion Control

grok-imagine — Grok Imagine

kling-3 — Kling 3.0

grok-imagine-video — Grok Imagine

qwen-image-2 — Qwen Image 2.0

Regenerate this page with node build-html.mjs after JSON changes. Markdown export: docs-final/11-pricing-and-credits.md via node docs-final/generate-pricing-md.mjs.

Deep link: index.html?model=veo-3-fast scrolls to the parameter block for that model (credits stay in this section).