Cliprise Business API

Build with AI.
One API, every creative format.

Generate images, video, and audio through a single unified REST endpoint. Async task system with webhooks, model switching, and variant support.

Base URL https://business.api.cliprise.app/app/cliprise
22
Image Models
32
Video Models
6
Audio Models
60
Total Models
1
POST /generateSend model + params
→
2
taskId returnedAsync job queued
→
3
Poll or webhookGET /status or callback
→
4
Download resultfileURL in response
⚡
Quickstart
First working request in 60s
🔑
Authentication
Bearer token setup
🗂
Model Catalog
All 60 models, filterable
🔗
Webhooks
Async callbacks
⚠️
Error Codes
Full error reference
💳
Credits & Pricing
Costs and rate limits
Quickstart

First working request

Two steps: send a generation request, then poll for the result.

Step 1 — Generate
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "MODEL_ID_HERE",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "A cinematic product photo of a luxury perfume bottle"
  }
}'
Response
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Step 2 — Poll status
curl -X GET "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID"
Result ready
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
Authentication

Bearer token — always server-side

⚠Never expose your API key in frontend JavaScript, mobile apps, or public repositories. All API calls must originate from your backend server.
Header AuthAuthorization: Bearer YOUR_API_KEY
Query AuthapiKey=YOUR_API_KEY
All endpointsHeader Auth required for /generate and Query Auth required for /status
Missing key → 401Returned with invalid_api_key error code
No credits → 402Top up your account. Validation errors don't consume credits.
401 — invalid key
{ "code": 401, "error": { "code": "invalid_api_key", "message": "Missing or invalid API key." } }
Model Catalog

All available models

Click any model name to view its full API reference.

Model name Model ID Type Output Pricing Status
nano-banana image png / jpg Loading... active
gpt-image-1-5 image png / jpg Loading... active
seedream-v4 image png / jpg Loading... active
seedream-v3 image png / jpg Loading... active
ideogram-character image png / jpg Loading... active
qwen-image image png / jpg Loading... active
imagen-v4 image png / jpg Loading... active
ideogram-v3 image png / jpg Loading... active
flux-kontext image png / jpg Loading... active
ideogram-reframe image png / jpg Loading... active
nano-banana-pro image png / jpg Loading... active
grok-imagine image png / jpg Loading... active
flux-2 image png / jpg Loading... active
z-image image png / jpg Loading... active
seedream-4-5 image png / jpg Loading... active
seedream-5-lite image png / jpg Loading... active
recraft-remove-bg image png / jpg Loading... active
recraft-upscaler image png / jpg Loading... active
nano-banana-2 image png / jpg Loading... active
qwen-image-2 image png / jpg Loading... active
gpt-image-1-mini image png / jpg Loading... active
gpt-image-2 image png / jpg Loading... active
veo-3-lite video mp4 Loading... active
veo-3-fast video mp4 Loading... active
veo-3-quality video mp4 Loading... active
sora-2 video mp4 Loading... active
wan-2-5 video mp4 Loading... active
kling-video-turbo video mp4 Loading... active
hailuo video mp4 Loading... active
hailuo-pro video mp4 Loading... active
runway video mp4 Loading... active
wan-2-2 video mp4 Loading... active
kling-2-1 video mp4 Loading... active
seedance-v1 video mp4 Loading... active
grok-imagine-video video mp4 Loading... active
hailuo-2-3 video mp4 Loading... active
seedance-v1-pro-fast video mp4 Loading... active
kling-2-6 video mp4 Loading... active
wan-speech-to-video video mp4 Loading... active
wan-animate video mp4 Loading... active
runway-aleph video mp4 Loading... active
wan-2-6 video mp4 Loading... active
wan-2-6-video video mp4 Loading... active
seedance-1-5-pro video mp4 Loading... active
kling-2-6-motion video mp4 Loading... active
kling-3-motion video mp4 Loading... active
kling-3 video mp4 Loading... active
kling-3-multi-shot video mp4 Loading... active
wan-2-7-video video mp4 Loading... active
seedance-2-fast video mp4 Loading... active
seedance-2 video mp4 Loading... active
happyhorse-1 video mp4 Loading... active
vidu-q3-pro video mp4 Loading... active
vidu-q3-turbo video mp4 Loading... active
elevenlabs-tts audio wav / mp3 Loading... active
elevenlabs-tts-turbo audio wav / mp3 Loading... active
elevenlabs-speech-to-text audio wav / mp3 Loading... active
elevenlabs-audio-isolation audio wav / mp3 Loading... active
elevenlabs-sound-effect audio wav / mp3 Loading... active
elevenlabs-v3-dialogue audio wav / mp3 Loading... active
Credits & Pricing

How credits work

Credit cost per modelCredit costs vary by model, resolution, duration, and mode.
Validation errors400-level validation failures do not consume credits.
Provider failuresCredits may be refunded for provider-side failures. Contact support for disputes.
Rate limitsPlan limits control requests/min, concurrent jobs, and queue depth. Exceeded → 429.
429 — rate limit
{ "code": 429, "error": { "code": "rate_limit_exceeded", "message": "Too many requests. Retry after cooldown." } }
Webhooks

Callback delivery

Pass callBackUrl in your request body to receive a POST notification when the task completes. Your endpoint must respond with 2xx within 10 seconds.

MethodHTTP POST to your URL
Timeout10 seconds — respond quickly
RetriesUp to 3 retries with exponential backoff on non-2xx or timeout
SigningContact support to enable webhook signature verification
Success payload
{
  "taskId": "1b363b46636f61fb7e0e48ed7879",
  "status": "success",
  "model": "model_id",
  "fileURL": "https://...",
  "createdAt": "2026-05-09T12:00:00Z",
  "completedAt": "2026-05-09T12:01:30Z"
}
Failure payload
{
  "taskId": "1b363b46636f61fb7e0e48ed7879",
  "status": "failure",
  "error": {
    "code": "provider_error",
    "message": "The generation provider failed to complete the task."
  }
}
Errors

Error reference

200 — Success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
400 — Error
{ "msg": "reason for failure" }
Support

Need help?

Email contact@cliprise.app — the team responds within one business day.

Enterprise

Invoice billing · Custom limits · Dedicated support · Custom model access

Contact Sales
API Reference Image Models Nano Banana
Image

Nano Banana

Model IDnano-banana
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
nano-banana
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the image
max.5000 characters
 required
input.output_format string Output format for the images
jpegpng
 optional
input.image_size string Size of the image to be generated
auto1:19:1616:93:22:35:44:53:44:321:9
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "nano-banana",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "output_format": "jpeg",
    "image_size": "auto"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "nano-banana",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "output_format": "jpeg",
    "image_size": "auto"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "nano-banana",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "output_format": "jpeg",
    "image_size": "auto"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
nano-banana
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to edit the image
max.5000 characters
 required
input.output_format string Output format for the images
jpegpng
 optional
input.image_size string Size of the image to be generated
auto1:19:1616:93:22:35:44:53:44:321:9
 optional
input.image_urls array List of URLs of input images for editing
max 10 images
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "nano-banana",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "output_format": "jpeg",
    "image_size": "auto",
    "image_urls": ["value"]
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "nano-banana",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "output_format": "jpeg",
    "image_size": "auto",
    "image_urls": ["value"]
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "nano-banana",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "output_format": "jpeg",
    "image_size": "auto",
    "image_urls": ["value"]
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Image Models GPT Image 1.5
Image

GPT Image 1.5

Model IDgpt-image-1-5
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
gpt-image-1-5
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the image
max.5000 characters
 required
input.aspect_ratio string The size of the generated image.
1:13:22:3
 optional
input.quality string The quality of the image
"medium""high"
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-image-1-5",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "quality": "your_value_here"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "gpt-image-1-5",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "quality": "your_value_here"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "gpt-image-1-5",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "quality": "your_value_here"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
gpt-image-1-5
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to edit the image
max.5000 characters
 required
input.aspect_ratio string The size of the generated image.
1:13:22:3
 optional
input.quality string The quality of the image
"medium""high"
 optional
input.input_urls array The URL of the image to edit.
max 16 images
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-image-1-5",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "quality": "your_value_here",
    "input_urls": ["value"]
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "gpt-image-1-5",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "quality": "your_value_here",
    "input_urls": ["value"]
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "gpt-image-1-5",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "quality": "your_value_here",
    "input_urls": ["value"]
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Image Models Seedream 4
Image

Seedream 4

Model IDseedream-v4
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
seedream-v4
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the image
max.5000 characters
 required
input.image_size string The size of the generated image.
squaresquare_hdlandscape_4_3portrait_2_3landscape_3_2portrait_9_16landscape_16_9landscape_21_9
 optional
input.image_resolution string Final image resolution
1K2K4K
 optional
input.seed number Random seed to control the stochasticity of image generation.
Min.10000Max.99999
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedream-v4",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "image_size": "square",
    "image_resolution": "1K",
    "seed": 10000
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "seedream-v4",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "image_size": "square",
    "image_resolution": "1K",
    "seed": 10000
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "seedream-v4",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "image_size": "square",
    "image_resolution": "1K",
    "seed": 10000
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
seedream-v4
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to edit the image
max.5000 characters
 required
input.image_size string The size of the generated image.
squaresquare_hdlandscape_4_3portrait_2_3landscape_3_2portrait_9_16landscape_16_9landscape_21_9
 optional
input.image_resolution string Final image resolution
1K2K4K
 optional
input.seed number Random seed to control the stochasticity of image generation.
Min.10000Max.99999
 optional
input.image_urls array List of URLs of input images for editing
max 10 images
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedream-v4",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "image_size": "square",
    "image_resolution": "1K",
    "seed": 10000,
    "image_urls": ["value"]
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "seedream-v4",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "image_size": "square",
    "image_resolution": "1K",
    "seed": 10000,
    "image_urls": ["value"]
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "seedream-v4",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "image_size": "square",
    "image_resolution": "1K",
    "seed": 10000,
    "image_urls": ["value"]
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Image Models Seedream 3
Image

Seedream 3

Model IDseedream-v3
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
seedream-v3
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the image
max.5000 characters
 required
input.image_size string The size of the generated image.
squaresquare_hdportrait_4_3landscape_4_3portrait_16_9landscape_16_9
 optional
input.guidance_scale number Controls how closely the output image aligns with the input prompt. Higher values mean stronger prompt correlation.
Min: 1Max: 10Step: 0.1
 optional
input.seed number Random seed to control the stochasticity of image generation.
Min.10000Max.99999
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedream-v3",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "image_size": "square",
    "guidance_scale": 1,
    "seed": 10000
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "seedream-v3",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "image_size": "square",
    "guidance_scale": 1,
    "seed": 10000
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "seedream-v3",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "image_size": "square",
    "guidance_scale": 1,
    "seed": 10000
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Image Models Ideogram Character
Image

Ideogram Character

Model IDideogram-character
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
ideogram-character
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to edit the image
max.5000 characters
 required
input.image_size string The size of the generated image.
squaresquare_hdportrait_4_3portrait_16_9landscape_4_3landscape_16_9
 optional
input.style string The style type to generate.
AUTOGENERALREALISTICDESIGNFICTION
 optional
input.rendering_speed string The rendering speed to use.
TURBOBALANCEDQUALITY
 optional
input.seed number Random seed to control the stochasticity of image generation.
Min.10000Max.99999
 optional
input.negative_prompt string The negative prompt for the generation
max.500 characters
 optional
input.reference_image_urls array The URL of the image to edit.
max 1 image
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "ideogram-character",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "image_size": "square",
    "style": "AUTO",
    "rendering_speed": "TURBO",
    "seed": 10000,
    "negative_prompt": "your_value_here",
    "reference_image_urls": ["value"]
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "ideogram-character",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "image_size": "square",
    "style": "AUTO",
    "rendering_speed": "TURBO",
    "seed": 10000,
    "negative_prompt": "your_value_here",
    "reference_image_urls": ["value"]
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "ideogram-character",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "image_size": "square",
    "style": "AUTO",
    "rendering_speed": "TURBO",
    "seed": 10000,
    "negative_prompt": "your_value_here",
    "reference_image_urls": ["value"]
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Image Models Qwen Image
Image

Qwen Image

Model IDqwen-image
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
qwen-image
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the image
max.5000 characters
 required
input.image_size string The size of the generated image.
squaresquare_hdportrait_4_3landscape_4_3portrait_16_9landscape_16_9
 optional
input.output_format string Output format for the images
jpegpng
 optional
input.acceleration string Output format for the images
noneregularhigh
 optional
input.seed number Random seed to control the stochasticity of image generation.
Min.10000Max.99999
 optional
input.guidance_scale number Controls how closely the output image aligns with the input prompt. Higher values mean stronger prompt correlation.
Min: 0Max: 20Step: 0.1
 optional
input.negative_prompt string The negative prompt for the generation
max.500 characters
 optional
input.num_inference_steps number The number of inference steps to perform
Min: 2Max: 250Step: 1
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "qwen-image",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "image_size": "square",
    "output_format": "jpeg",
    "acceleration": "none",
    "seed": 10000,
    "guidance_scale": 0,
    "negative_prompt": "your_value_here",
    "num_inference_steps": 2
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "qwen-image",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "image_size": "square",
    "output_format": "jpeg",
    "acceleration": "none",
    "seed": 10000,
    "guidance_scale": 0,
    "negative_prompt": "your_value_here",
    "num_inference_steps": 2
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "qwen-image",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "image_size": "square",
    "output_format": "jpeg",
    "acceleration": "none",
    "seed": 10000,
    "guidance_scale": 0,
    "negative_prompt": "your_value_here",
    "num_inference_steps": 2
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
qwen-image
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to edit the image
max.5000 characters
 required
input.image_size string The size of the generated image.
squaresquare_hdportrait_4_3landscape_4_3portrait_16_9landscape_16_9
 optional
input.output_format string Output format for the images
jpegpng
 optional
input.acceleration string Output format for the images
noneregularhigh
 optional
input.seed number Random seed to control the stochasticity of image generation.
Min.10000Max.99999
 optional
input.guidance_scale number Controls how closely the output image aligns with the input prompt. Higher values mean stronger prompt correlation.
Min: 0Max: 20Step: 0.1
 optional
input.negative_prompt string The negative prompt for the generation
max.500 characters
 optional
input.num_inference_steps number The number of inference steps to perform
Min: 2Max: 250Step: 1
 optional
input.image_url string The URL of the image to edit.
max 1 image
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "qwen-image",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "image_size": "square",
    "output_format": "jpeg",
    "acceleration": "none",
    "seed": 10000,
    "guidance_scale": 0,
    "negative_prompt": "your_value_here",
    "num_inference_steps": 2,
    "image_url": "your_value_here"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "qwen-image",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "image_size": "square",
    "output_format": "jpeg",
    "acceleration": "none",
    "seed": 10000,
    "guidance_scale": 0,
    "negative_prompt": "your_value_here",
    "num_inference_steps": 2,
    "image_url": "your_value_here"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "qwen-image",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "image_size": "square",
    "output_format": "jpeg",
    "acceleration": "none",
    "seed": 10000,
    "guidance_scale": 0,
    "negative_prompt": "your_value_here",
    "num_inference_steps": 2,
    "image_url": "your_value_here"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Image Models Imagen 4
Image

Imagen 4

Model IDimagen-v4
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
imagen-v4imagen-v4-ultra
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the image
max.5000 characters
 required
input.aspect_ratio string The size of the generated image.
1:13:44:39:1616:9
 optional
input.negative_prompt string The negative prompt for the generation
max.500 characters
 optional
input.seed number Random seed to control the stochasticity of image generation.
Min.10000Max.99999
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "imagen-v4",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "negative_prompt": "your_value_here",
    "seed": 10000
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "imagen-v4",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "negative_prompt": "your_value_here",
    "seed": 10000
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "imagen-v4",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "negative_prompt": "your_value_here",
    "seed": 10000
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Image Models Ideogram 3
Image

Ideogram 3

Model IDideogram-v3
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
ideogram-v3
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the image
max.5000 characters
 required
input.image_size string The size of the generated image.
squaresquare_hdportrait_4_3portrait_16_9landscape_4_3landscape_16_9
 optional
input.style string The style type to generate.
AUTOGENERALREALISTICDESIGNFICTION
 optional
input.rendering_speed string The rendering speed to use.
TURBOBALANCEDQUALITY
 optional
input.seed number Random seed to control the stochasticity of image generation.
Min.10000Max.99999
 optional
input.negative_prompt string The negative prompt for the generation
max.500 characters
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "ideogram-v3",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "image_size": "square",
    "style": "AUTO",
    "rendering_speed": "TURBO",
    "seed": 10000,
    "negative_prompt": "your_value_here"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "ideogram-v3",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "image_size": "square",
    "style": "AUTO",
    "rendering_speed": "TURBO",
    "seed": 10000,
    "negative_prompt": "your_value_here"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "ideogram-v3",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "image_size": "square",
    "style": "AUTO",
    "rendering_speed": "TURBO",
    "seed": 10000,
    "negative_prompt": "your_value_here"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Image Models Flux Kontext
Image

Flux Kontext

Model IDflux-kontext
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
flux-kontext-proflux-kontext-max
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
prompt string The text prompt used to generate the image
max.5000 characters
 required
outputFormat string Output format for the images
jpegpng
 optional
aspectRatio string The size of the output image
1:14:33:49:1616:921:9
 optional
enableTranslation boolean Whether to translate text in image
truefalse
 optional
watermark string Watermark identifier to add to the generated image. optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "flux-kontext-pro",
  "callBackUrl": "https://your-app.com/webhook",
  "prompt": "your_value_here",
  "outputFormat": "jpeg",
  "aspectRatio": "1:1",
  "enableTranslation": true,
  "watermark": "your_value_here"
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "flux-kontext-pro",
  "callBackUrl": "https://your-app.com/webhook",
  "prompt": "your_value_here",
  "outputFormat": "jpeg",
  "aspectRatio": "1:1",
  "enableTranslation": true,
  "watermark": "your_value_here"
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "flux-kontext-pro",
  "callBackUrl": "https://your-app.com/webhook",
  "prompt": "your_value_here",
  "outputFormat": "jpeg",
  "aspectRatio": "1:1",
  "enableTranslation": true,
  "watermark": "your_value_here"
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
flux-kontext-proflux-kontext-max
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
prompt string The text prompt used to edit the image
max.5000 characters
 required
outputFormat string Output format for the images
jpegpng
 optional
aspectRatio string The size of the output image
1:14:33:49:1616:921:9
 optional
enableTranslation boolean Whether to translate text in image
truefalse
 optional
watermark string Watermark identifier to add to the generated image. optional
inputImage string The URL of the image to edit.
max 1 image
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "flux-kontext-pro",
  "callBackUrl": "https://your-app.com/webhook",
  "prompt": "your_value_here",
  "outputFormat": "jpeg",
  "aspectRatio": "1:1",
  "enableTranslation": true,
  "watermark": "your_value_here",
  "inputImage": "your_value_here"
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "flux-kontext-pro",
  "callBackUrl": "https://your-app.com/webhook",
  "prompt": "your_value_here",
  "outputFormat": "jpeg",
  "aspectRatio": "1:1",
  "enableTranslation": true,
  "watermark": "your_value_here",
  "inputImage": "your_value_here"
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "flux-kontext-pro",
  "callBackUrl": "https://your-app.com/webhook",
  "prompt": "your_value_here",
  "outputFormat": "jpeg",
  "aspectRatio": "1:1",
  "enableTranslation": true,
  "watermark": "your_value_here",
  "inputImage": "your_value_here"
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Image Models Ideogram Reframe
Image

Ideogram Reframe

Model IDideogram-reframe
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
ideogram-reframe
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to edit the image
max.5000 characters
 required
input.image_size string The size of the generated image.
squaresquare_hdportrait_4_3portrait_16_9landscape_4_3landscape_16_9
 optional
input.style string The style type to generate.
AUTOGENERALREALISTICDESIGNFICTION
 optional
input.rendering_speed string The rendering speed to use.
TURBOBALANCEDQUALITY
 optional
input.seed number Random seed to control the stochasticity of image generation.
Min.10000Max.99999
 optional
input.image_url array The URL of the image to edit.
max 1 image
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "ideogram-reframe",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "image_size": "square",
    "style": "AUTO",
    "rendering_speed": "TURBO",
    "seed": 10000,
    "image_url": ["value"]
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "ideogram-reframe",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "image_size": "square",
    "style": "AUTO",
    "rendering_speed": "TURBO",
    "seed": 10000,
    "image_url": ["value"]
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "ideogram-reframe",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "image_size": "square",
    "style": "AUTO",
    "rendering_speed": "TURBO",
    "seed": 10000,
    "image_url": ["value"]
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Image Models Nano Banana Pro
Image

Nano Banana Pro

Model IDnano-banana-pro
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
nano-banana-pro
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the image
max.10000 characters
 required
input.aspect_ratio string Size of the image to be generated
1:12:33:24:33:44:55:49:1616:921:9
 optional
input.output_format string Output format for the images
jpgpng
 optional
input.resolution string The quality of the image
1K2K4K
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "nano-banana-pro",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "output_format": "jpg",
    "resolution": "1K"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "nano-banana-pro",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "output_format": "jpg",
    "resolution": "1K"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "nano-banana-pro",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "output_format": "jpg",
    "resolution": "1K"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
nano-banana-pro
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to edit the image
max.10000 characters
 required
input.aspect_ratio string Size of the image to be generated
1:12:33:24:33:44:55:49:1616:921:9
 optional
input.output_format string Output format for the images
jpgpng
 optional
input.resolution string The quality of the image
1K2K4K
 optional
input.image_input array The URL of the image to edit.
max 8 images
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "nano-banana-pro",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "output_format": "jpg",
    "resolution": "1K",
    "image_input": ["value"]
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "nano-banana-pro",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "output_format": "jpg",
    "resolution": "1K",
    "image_input": ["value"]
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "nano-banana-pro",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "output_format": "jpg",
    "resolution": "1K",
    "image_input": ["value"]
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Image Models Grok Imagine
Image

Grok Imagine

Model IDgrok-imagine
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
grok-imagine
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the image
max.5000 characters
 required
input.aspect_ratio string Size of the image to be generated
2:33:21:116:99:16
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "grok-imagine",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "2:3"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "grok-imagine",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "2:3"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "grok-imagine",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "2:3"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
grok-imagine
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to edit the image
max.5000 characters
 required
input.aspect_ratio string Size of the image to be generated
2:33:21:116:99:16
 optional
input.image_urls string The URL of the image to edit.
max 1 image
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "grok-imagine",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "2:3",
    "image_urls": "your_value_here"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "grok-imagine",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "2:3",
    "image_urls": "your_value_here"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "grok-imagine",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "2:3",
    "image_urls": "your_value_here"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Image Models Flux 2
Image

Flux 2

Model IDflux-2
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
flux-2-proflux-2-flex
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the image
max.5000 characters
 required
input.aspect_ratio string Size of the image to be generated
1:14:33:416:99:163:22:3
 optional
input.resolution string The resolution of the output image.
1K2K
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "flux-2-pro",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "resolution": "1K"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "flux-2-pro",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "resolution": "1K"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "flux-2-pro",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "resolution": "1K"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
flux-2-proflux-2-flex
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to edit the image
max.5000 characters
 required
input.aspect_ratio string Size of the image to be generated
1:14:33:416:99:163:22:3
 optional
input.resolution string The resolution of the output image.
1K2K
 optional
input.input_urls array The URL of the image to edit.
max 8 images
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "flux-2-pro",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "input_urls": ["value"]
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "flux-2-pro",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "input_urls": ["value"]
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "flux-2-pro",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "input_urls": ["value"]
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Image Models Z Image
Image

Z Image

Model IDz-image
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
z-image
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the image
max.800 characters
 required
input.aspect_ratio string Size of the image to be generated
4:33:416:99:1621:1
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "z-image",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "4:3"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "z-image",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "4:3"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "z-image",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "4:3"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Image Models Seedream 4.5
Image

Seedream 4.5

Model IDseedream-4-5
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
seedream-4-5
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the image
max.3000 characters
 required
input.aspect_ratio string Size of the image to be generated
1:14:33:416:99:162:33:221:9
 optional
input.quality string The quality of the outpur image.
basichigh
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedream-4-5",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "quality": "basic"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "seedream-4-5",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "quality": "basic"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "seedream-4-5",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "quality": "basic"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
seedream-4-5
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to edit the image
max.3000 characters
 required
input.aspect_ratio string Size of the image to be generated
1:14:33:416:99:162:33:221:9
 optional
input.quality string The quality of the outpur image.
basichigh
 optional
input.image_urls array The URL of the image to edit.
max 1 image
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedream-4-5",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "quality": "basic",
    "image_urls": ["value"]
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "seedream-4-5",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "quality": "basic",
    "image_urls": ["value"]
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "seedream-4-5",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "quality": "basic",
    "image_urls": ["value"]
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Image Models Seedream 5 Lite
Image

Seedream 5 Lite

Model IDseedream-5-lite
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
seedream-5-lite
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the image
max.3000 characters
 required
input.aspect_ratio string Size of the image to be generated
1:14:33:416:99:162:33:221:9
 optional
input.quality string The quality of the outpur image.
basichigh
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedream-5-lite",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "quality": "basic"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "seedream-5-lite",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "quality": "basic"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "seedream-5-lite",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "quality": "basic"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
seedream-5-lite
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to edit the image
max.3000 characters
 required
input.aspect_ratio string Size of the image to be generated
1:14:33:416:99:162:33:221:9
 optional
input.quality string The quality of the outpur image.
basichigh
 optional
input.image_urls array The URL of the image to edit.
max 1 image
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedream-5-lite",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "quality": "basic",
    "image_urls": ["value"]
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "seedream-5-lite",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "quality": "basic",
    "image_urls": ["value"]
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "seedream-5-lite",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "quality": "basic",
    "image_urls": ["value"]
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Image Models recraft-remove-bg
Image

recraft-remove-bg

Model IDrecraft-remove-bg
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
recraft-remove-bg
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.image string The URL of the image to edit.
max 1 image
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "recraft-remove-bg",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "image": "your_value_here"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "recraft-remove-bg",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "image": "your_value_here"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "recraft-remove-bg",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "image": "your_value_here"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Image Models recraft-upscaler
Image

recraft-upscaler

Model IDrecraft-upscaler
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
recraft-upscaler
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.image string The URL of the image to edit.
max 1 image
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "recraft-upscaler",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "image": "your_value_here"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "recraft-upscaler",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "image": "your_value_here"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "recraft-upscaler",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "image": "your_value_here"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Image Models Nano Banana 2
Image

Nano Banana 2

Model IDnano-banana-2
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
nano-banana-2
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the image
max.20000 characters
 required
input.aspect_ratio string Size of the image to be generated
1:12:33:24:33:44:55:49:1616:921:9
 optional
input.output_format string Output format for the images
jpgpng
 optional
input.resolution string The quality of the image
1K2K4K
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "nano-banana-2",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "output_format": "jpg",
    "resolution": "1K"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "nano-banana-2",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "output_format": "jpg",
    "resolution": "1K"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "nano-banana-2",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "output_format": "jpg",
    "resolution": "1K"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
nano-banana-2
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to edit the image
max.20000 characters
 required
input.aspect_ratio string Size of the image to be generated
1:12:33:24:33:44:55:49:1616:921:9
 optional
input.output_format string Output format for the images
jpgpng
 optional
input.resolution string The quality of the image
1K2K4K
 optional
input.image_input array The URL of the image to edit.
max 14 images
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "nano-banana-2",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "output_format": "jpg",
    "resolution": "1K",
    "image_input": ["value"]
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "nano-banana-2",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "output_format": "jpg",
    "resolution": "1K",
    "image_input": ["value"]
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "nano-banana-2",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "output_format": "jpg",
    "resolution": "1K",
    "image_input": ["value"]
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Image Models Qwen 2
Image

Qwen 2

Model IDqwen-image-2
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
qwen-image-2
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the image
max.800 characters
 required
input.image_size string Size of the image to be generated
1:12:33:23:44:39:1616:921:9
 optional
input.output_format string Output format for the images
jpegpng
 optional
input.seed number Random seed to control the stochasticity of image generation.
Min.10000Max.99999
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "qwen-image-2",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "image_size": "1:1",
    "output_format": "jpeg",
    "seed": 10000
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "qwen-image-2",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "image_size": "1:1",
    "output_format": "jpeg",
    "seed": 10000
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "qwen-image-2",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "image_size": "1:1",
    "output_format": "jpeg",
    "seed": 10000
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
qwen-image-2
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to edit the image
max.800 characters
 required
input.image_size string Size of the image to be generated
1:12:33:23:44:39:1616:921:9
 optional
input.output_format string Output format for the images
jpegpng
 optional
input.seed number Random seed to control the stochasticity of image generation.
Min.10000Max.99999
 optional
input.image_url string The URL of the image to edit.
max 1 image
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "qwen-image-2",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "image_size": "1:1",
    "output_format": "jpeg",
    "seed": 10000,
    "image_url": "your_value_here"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "qwen-image-2",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "image_size": "1:1",
    "output_format": "jpeg",
    "seed": 10000,
    "image_url": "your_value_here"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "qwen-image-2",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "image_size": "1:1",
    "output_format": "jpeg",
    "seed": 10000,
    "image_url": "your_value_here"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Image Models GPT Image 1 Mini
Image

GPT Image 1 Mini

Model IDgpt-image-1-mini
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
gpt-image-1-mini
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the image
max.5000 characters
 required
input.aspect_ratio string The size of the generated image.
1:13:22:3
 optional
input.quality string The quality of the image
"medium""high"
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-image-1-mini",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "quality": "your_value_here"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "gpt-image-1-mini",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "quality": "your_value_here"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "gpt-image-1-mini",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "quality": "your_value_here"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
gpt-image-1-mini
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to edit the image
max.5000 characters
 required
input.aspect_ratio string The size of the generated image.
1:13:22:3
 optional
input.quality string The quality of the image
"medium""high"
 optional
input.input_urls array The URL of the image to edit.
max 16 images
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-image-1-mini",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "quality": "your_value_here",
    "input_urls": ["value"]
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "gpt-image-1-mini",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "quality": "your_value_here",
    "input_urls": ["value"]
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "gpt-image-1-mini",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "quality": "your_value_here",
    "input_urls": ["value"]
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Image Models GPT Image 2
Image

GPT Image 2

Model IDgpt-image-2
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
gpt-image-2
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the image
max.5000 characters
 required
input.aspect_ratio string The size of the generated image.
1:13:22:3
 optional
input.quality string The quality of the image
"medium""high"
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-image-2",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "quality": "your_value_here"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "gpt-image-2",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "quality": "your_value_here"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "gpt-image-2",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "quality": "your_value_here"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
gpt-image-2
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to edit the image
max.5000 characters
 required
input.aspect_ratio string The size of the generated image.
1:13:22:3
 optional
input.quality string The quality of the image
"medium""high"
 optional
input.input_urls array The URL of the image to edit.
max 16 images
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-image-2",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "quality": "your_value_here",
    "input_urls": ["value"]
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "gpt-image-2",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "quality": "your_value_here",
    "input_urls": ["value"]
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "gpt-image-2",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "quality": "your_value_here",
    "input_urls": ["value"]
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Video Models Veo 3.1 Lite
Video

Veo 3.1 Lite

Model IDveo-3-lite
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
veo-3-lite
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
prompt string The text prompt used to generate the video
max.5000 characters
 required
watermark string Watermark text. Optional parameter If provided, a watermark will be added to the generated video MyBrand optional
aspectRatio string Size of the video to be generated
16:99:16Auto
 optional
seeds number Random seed parameter for controlling the randomness of generated content.
Min.10000Max.99999
 optional
generationType string Video generation mode
FIRST_AND_LAST_FRAMES_2_VIDEO
 required
enableTranslation boolean Enable prompt translation to English. When set to true, the system will automatically translate prompts to English before video generation for better generation results
truefalse
 optional
imageUrls string List of URLs of input images for reference
2 images compulsory
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "veo-3-lite",
  "callBackUrl": "https://your-app.com/webhook",
  "prompt": "your_value_here",
  "watermark": "your_value_here",
  "aspectRatio": "16:9",
  "seeds": 10000,
  "generationType": "FIRST_AND_LAST_FRAMES_2_VIDEO",
  "enableTranslation": true,
  "imageUrls": "your_value_here"
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "veo-3-lite",
  "callBackUrl": "https://your-app.com/webhook",
  "prompt": "your_value_here",
  "watermark": "your_value_here",
  "aspectRatio": "16:9",
  "seeds": 10000,
  "generationType": "FIRST_AND_LAST_FRAMES_2_VIDEO",
  "enableTranslation": true,
  "imageUrls": "your_value_here"
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "veo-3-lite",
  "callBackUrl": "https://your-app.com/webhook",
  "prompt": "your_value_here",
  "watermark": "your_value_here",
  "aspectRatio": "16:9",
  "seeds": 10000,
  "generationType": "FIRST_AND_LAST_FRAMES_2_VIDEO",
  "enableTranslation": true,
  "imageUrls": "your_value_here"
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
veo-3-lite
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
prompt string The text prompt used to generate the video
max.5000 characters
 required
watermark string Watermark text. Optional parameter If provided, a watermark will be added to the generated video MyBrand optional
aspectRatio string Size of the video to be generated
16:99:16Auto
 optional
seeds number Random seed parameter for controlling the randomness of generated content.
Min.10000Max.99999
 optional
generationType string Video generation mode
TEXT_2_VIDEO
 required
enableTranslation boolean Enable prompt translation to English. When set to true, the system will automatically translate prompts to English before video generation for better generation results
truefalse
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "veo-3-lite",
  "callBackUrl": "https://your-app.com/webhook",
  "prompt": "your_value_here",
  "watermark": "your_value_here",
  "aspectRatio": "16:9",
  "seeds": 10000,
  "generationType": "TEXT_2_VIDEO",
  "enableTranslation": true
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "veo-3-lite",
  "callBackUrl": "https://your-app.com/webhook",
  "prompt": "your_value_here",
  "watermark": "your_value_here",
  "aspectRatio": "16:9",
  "seeds": 10000,
  "generationType": "TEXT_2_VIDEO",
  "enableTranslation": true
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "veo-3-lite",
  "callBackUrl": "https://your-app.com/webhook",
  "prompt": "your_value_here",
  "watermark": "your_value_here",
  "aspectRatio": "16:9",
  "seeds": 10000,
  "generationType": "TEXT_2_VIDEO",
  "enableTranslation": true
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Video Models Veo 3.1 Fast
Video

Veo 3.1 Fast

Model IDveo-3-fast
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
veo-3-fast
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
prompt string The text prompt used to generate the video
max.5000 characters
 required
watermark string Watermark text. Optional parameter If provided, a watermark will be added to the generated video MyBrand optional
aspectRatio string Size of the video to be generated
16:99:16Auto
 optional
seeds number Random seed parameter for controlling the randomness of generated content.
Min.10000Max.99999
 optional
generationType string Video generation mode
FIRST_AND_LAST_FRAMES_2_VIDEO
 required
enableTranslation boolean Enable prompt translation to English. When set to true, the system will automatically translate prompts to English before video generation for better generation results
truefalse
 optional
imageUrls string List of URLs of input images for reference
2 images compulsory
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "veo-3-fast",
  "callBackUrl": "https://your-app.com/webhook",
  "prompt": "your_value_here",
  "watermark": "your_value_here",
  "aspectRatio": "16:9",
  "seeds": 10000,
  "generationType": "FIRST_AND_LAST_FRAMES_2_VIDEO",
  "enableTranslation": true,
  "imageUrls": "your_value_here"
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "veo-3-fast",
  "callBackUrl": "https://your-app.com/webhook",
  "prompt": "your_value_here",
  "watermark": "your_value_here",
  "aspectRatio": "16:9",
  "seeds": 10000,
  "generationType": "FIRST_AND_LAST_FRAMES_2_VIDEO",
  "enableTranslation": true,
  "imageUrls": "your_value_here"
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "veo-3-fast",
  "callBackUrl": "https://your-app.com/webhook",
  "prompt": "your_value_here",
  "watermark": "your_value_here",
  "aspectRatio": "16:9",
  "seeds": 10000,
  "generationType": "FIRST_AND_LAST_FRAMES_2_VIDEO",
  "enableTranslation": true,
  "imageUrls": "your_value_here"
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
veo-3-fast
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
prompt string The text prompt used to generate the video
max.5000 characters
 required
watermark string Watermark text. Optional parameter If provided, a watermark will be added to the generated video MyBrand optional
aspectRatio string Size of the video to be generated
16:99:16Auto
 optional
seeds number Random seed parameter for controlling the randomness of generated content.
Min.10000Max.99999
 optional
generationType string Video generation mode
REFERENCE_2_VIDEO
 required
enableTranslation boolean Enable prompt translation to English. When set to true, the system will automatically translate prompts to English before video generation for better generation results
truefalse
 optional
imageUrls string List of URLs of input images for reference
Max. 3 images
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "veo-3-fast",
  "callBackUrl": "https://your-app.com/webhook",
  "prompt": "your_value_here",
  "watermark": "your_value_here",
  "aspectRatio": "16:9",
  "seeds": 10000,
  "generationType": "REFERENCE_2_VIDEO",
  "enableTranslation": true,
  "imageUrls": "your_value_here"
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "veo-3-fast",
  "callBackUrl": "https://your-app.com/webhook",
  "prompt": "your_value_here",
  "watermark": "your_value_here",
  "aspectRatio": "16:9",
  "seeds": 10000,
  "generationType": "REFERENCE_2_VIDEO",
  "enableTranslation": true,
  "imageUrls": "your_value_here"
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "veo-3-fast",
  "callBackUrl": "https://your-app.com/webhook",
  "prompt": "your_value_here",
  "watermark": "your_value_here",
  "aspectRatio": "16:9",
  "seeds": 10000,
  "generationType": "REFERENCE_2_VIDEO",
  "enableTranslation": true,
  "imageUrls": "your_value_here"
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
veo-3-fast
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
prompt string The text prompt used to generate the video
max.5000 characters
 required
watermark string Watermark text. Optional parameter If provided, a watermark will be added to the generated video MyBrand optional
aspectRatio string Size of the video to be generated
16:99:16Auto
 optional
seeds number Random seed parameter for controlling the randomness of generated content.
Min.10000Max.99999
 optional
generationType string Video generation mode
TEXT_2_VIDEO
 required
enableTranslation boolean Enable prompt translation to English. When set to true, the system will automatically translate prompts to English before video generation for better generation results
truefalse
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "veo-3-fast",
  "callBackUrl": "https://your-app.com/webhook",
  "prompt": "your_value_here",
  "watermark": "your_value_here",
  "aspectRatio": "16:9",
  "seeds": 10000,
  "generationType": "TEXT_2_VIDEO",
  "enableTranslation": true
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "veo-3-fast",
  "callBackUrl": "https://your-app.com/webhook",
  "prompt": "your_value_here",
  "watermark": "your_value_here",
  "aspectRatio": "16:9",
  "seeds": 10000,
  "generationType": "TEXT_2_VIDEO",
  "enableTranslation": true
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "veo-3-fast",
  "callBackUrl": "https://your-app.com/webhook",
  "prompt": "your_value_here",
  "watermark": "your_value_here",
  "aspectRatio": "16:9",
  "seeds": 10000,
  "generationType": "TEXT_2_VIDEO",
  "enableTranslation": true
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Video Models Veo 3.1 Quality
Video

Veo 3.1 Quality

Model IDveo-3-quality
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
veo-3-quality
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
prompt string The text prompt used to generate the video
max.5000 characters
 required
watermark string Watermark text. Optional parameter If provided, a watermark will be added to the generated video MyBrand optional
aspectRatio string Size ot the video to be generated
16:99:16Auto
 optional
seeds number Random seed parameter for controlling the randomness of generated content.
Min.10000Max.99999
 optional
generationType string Video generation mode
FIRST_AND_LAST_FRAMES_2_VIDEO
 required
enableTranslation boolean Enable prompt translation to English. When set to true, the system will automatically translate prompts to English before video generation for better generation results
truefalse
 optional
imageUrls string List of URLs of input images for reference
2 images compulsory
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "veo-3-quality",
  "callBackUrl": "https://your-app.com/webhook",
  "prompt": "your_value_here",
  "watermark": "your_value_here",
  "aspectRatio": "16:9",
  "seeds": 10000,
  "generationType": "FIRST_AND_LAST_FRAMES_2_VIDEO",
  "enableTranslation": true,
  "imageUrls": "your_value_here"
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "veo-3-quality",
  "callBackUrl": "https://your-app.com/webhook",
  "prompt": "your_value_here",
  "watermark": "your_value_here",
  "aspectRatio": "16:9",
  "seeds": 10000,
  "generationType": "FIRST_AND_LAST_FRAMES_2_VIDEO",
  "enableTranslation": true,
  "imageUrls": "your_value_here"
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "veo-3-quality",
  "callBackUrl": "https://your-app.com/webhook",
  "prompt": "your_value_here",
  "watermark": "your_value_here",
  "aspectRatio": "16:9",
  "seeds": 10000,
  "generationType": "FIRST_AND_LAST_FRAMES_2_VIDEO",
  "enableTranslation": true,
  "imageUrls": "your_value_here"
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
veo-3-quality
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
prompt string The text prompt used to generate the video
max.5000 characters
 required
watermark string Watermark text. Optional parameter If provided, a watermark will be added to the generated video MyBrand optional
aspectRatio string Size of the video to be generated
16:99:16Auto
 optional
seeds number Random seed parameter for controlling the randomness of generated content.
Min.10000Max.99999
 optional
generationType string Video generation mode
TEXT_2_VIDEO
 required
enableTranslation boolean Enable prompt translation to English. When set to true, the system will automatically translate prompts to English before video generation for better generation results
truefalse
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "veo-3-quality",
  "callBackUrl": "https://your-app.com/webhook",
  "prompt": "your_value_here",
  "watermark": "your_value_here",
  "aspectRatio": "16:9",
  "seeds": 10000,
  "generationType": "TEXT_2_VIDEO",
  "enableTranslation": true
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "veo-3-quality",
  "callBackUrl": "https://your-app.com/webhook",
  "prompt": "your_value_here",
  "watermark": "your_value_here",
  "aspectRatio": "16:9",
  "seeds": 10000,
  "generationType": "TEXT_2_VIDEO",
  "enableTranslation": true
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "veo-3-quality",
  "callBackUrl": "https://your-app.com/webhook",
  "prompt": "your_value_here",
  "watermark": "your_value_here",
  "aspectRatio": "16:9",
  "seeds": 10000,
  "generationType": "TEXT_2_VIDEO",
  "enableTranslation": true
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Video Models Sora 2
Video

Sora 2

Model IDsora-2
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
sora-2
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
max.5000 characters
 required
input.aspect_ratio string Size of the video to be generated
portraitlandscape
 optional
input.remove_watermark boolean Remove Sora Watermark.
truefalse
 optional
input.n_frames string The duration of the generated video in seconds
4812
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "sora-2",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "portrait",
    "remove_watermark": true,
    "n_frames": "4"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "sora-2",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "portrait",
    "remove_watermark": true,
    "n_frames": "4"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "sora-2",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "portrait",
    "remove_watermark": true,
    "n_frames": "4"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
sora-2
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
max.5000 characters
 required
input.aspect_ratio string Size of the video to be generated
portraitlandscape
 optional
input.remove_watermark boolean Remove Sora Watermark.
truefalse
 optional
input.n_frames string The duration of the generated video in seconds
4812
 required
input.image_urls array List of URLs of input images for reference
Max. 1 image
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "sora-2",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "portrait",
    "remove_watermark": true,
    "n_frames": "4",
    "image_urls": ["value"]
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "sora-2",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "portrait",
    "remove_watermark": true,
    "n_frames": "4",
    "image_urls": ["value"]
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "sora-2",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "portrait",
    "remove_watermark": true,
    "n_frames": "4",
    "image_urls": ["value"]
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Video Models Wan 2.5
Video

Wan 2.5

Model IDwan-2-5
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
wan-2-5
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
max.800 characters
 required
input.aspect_ratio string Size of the video to be generated
16:99:161:1
 optional
input.resolution string The resolution of the video to be generated.
720p1080p
 required
input.negative_prompt string Negative prompt used to describe content to avoid.
Max. 500 characters
 optional
input.seed number Random seed parameter for controlling the randomness of generated content.
Min.10000Max.99999
 optional
input.duration string The duration of the generated video in seconds
510
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan-2-5",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "16:9",
    "resolution": "your_value_here",
    "negative_prompt": "your_value_here",
    "seed": 10000,
    "duration": "your_value_here"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "wan-2-5",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "16:9",
    "resolution": "your_value_here",
    "negative_prompt": "your_value_here",
    "seed": 10000,
    "duration": "your_value_here"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "wan-2-5",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "16:9",
    "resolution": "your_value_here",
    "negative_prompt": "your_value_here",
    "seed": 10000,
    "duration": "your_value_here"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
wan-2-5
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
max.800 characters
 required
input.resolution string The resolution of the video to be generated.
720p1080p
 required
input.negative_prompt string Negative prompt used to describe content to avoid.
Max. 500 characters
 optional
input.seed number Random seed parameter for controlling the randomness of generated content.
Min.10000Max.99999
 optional
input.duration string The duration of the generated video in seconds
510
 required
input.image_url string List of URLs of input images for reference
Max. 1 image
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan-2-5",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "resolution": "your_value_here",
    "negative_prompt": "your_value_here",
    "seed": 10000,
    "duration": "your_value_here",
    "image_url": "your_value_here"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "wan-2-5",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "resolution": "your_value_here",
    "negative_prompt": "your_value_here",
    "seed": 10000,
    "duration": "your_value_here",
    "image_url": "your_value_here"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "wan-2-5",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "resolution": "your_value_here",
    "negative_prompt": "your_value_here",
    "seed": 10000,
    "duration": "your_value_here",
    "image_url": "your_value_here"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Video Models Kling 2.5 Turbo
Video

Kling 2.5 Turbo

Model IDkling-video-turbo
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
kling-video-turbo
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
max.2500 characters
 required
input.duration string The duration of the generated video in seconds
510
 required
input.aspect_ratio string Size of the video to be generated
16:99:161:1
 optional
input.negative_prompt string Negative prompt used to describe content to avoid.
Max. 500 characters
 optional
input.cfg_scale number The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt
Min: 0Max: 1Step: 0.1
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling-video-turbo",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "duration": "your_value_here",
    "aspect_ratio": "16:9",
    "negative_prompt": "your_value_here",
    "cfg_scale": 0
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "kling-video-turbo",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "duration": "your_value_here",
    "aspect_ratio": "16:9",
    "negative_prompt": "your_value_here",
    "cfg_scale": 0
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "kling-video-turbo",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "duration": "your_value_here",
    "aspect_ratio": "16:9",
    "negative_prompt": "your_value_here",
    "cfg_scale": 0
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
kling-video-turbo
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
max.2500 characters
 required
input.duration string The duration of the generated video in seconds
510
 required
input.aspect_ratio string Size of the video to be generated
16:99:161:1
 optional
input.negative_prompt string Negative prompt used to describe content to avoid.
Max. 500 characters
 optional
input.cfg_scale number The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt
Min: 0Max: 1Step: 0.1
 optional
input.image_url string List of URLs of input images for reference
Max. 1 image
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling-video-turbo",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "duration": "your_value_here",
    "aspect_ratio": "16:9",
    "negative_prompt": "your_value_here",
    "cfg_scale": 0,
    "image_url": "your_value_here"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "kling-video-turbo",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "duration": "your_value_here",
    "aspect_ratio": "16:9",
    "negative_prompt": "your_value_here",
    "cfg_scale": 0,
    "image_url": "your_value_here"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "kling-video-turbo",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "duration": "your_value_here",
    "aspect_ratio": "16:9",
    "negative_prompt": "your_value_here",
    "cfg_scale": 0,
    "image_url": "your_value_here"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Video Models Hailuo
Video

Hailuo

Model IDhailuo
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
hailuo
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
max.1500 characters
 required
input.duration string The duration of the generated video in seconds
610
 required
input.prompt_optimizer boolean Whether to use the model's prompt optimizer
truefalse
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "hailuo",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "duration": "your_value_here",
    "prompt_optimizer": false
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "hailuo",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "duration": "your_value_here",
    "prompt_optimizer": false
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "hailuo",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "duration": "your_value_here",
    "prompt_optimizer": false
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
hailuo
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
max.1500 characters
 required
input.duration string The duration of the generated video in seconds
610
 required
input.prompt_optimizer boolean Whether to use the model's prompt optimizer
truefalse
 optional
input.image_url string List of URLs of input images for reference
Max. 1 image
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "hailuo",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "duration": "your_value_here",
    "prompt_optimizer": false,
    "image_url": "your_value_here"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "hailuo",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "duration": "your_value_here",
    "prompt_optimizer": false,
    "image_url": "your_value_here"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "hailuo",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "duration": "your_value_here",
    "prompt_optimizer": false,
    "image_url": "your_value_here"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Video Models Hailuo 02 PRO
Video

Hailuo 02 PRO

Model IDhailuo-pro
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
hailuo-pro
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
max.1500 characters
 required
input.prompt_optimizer boolean Whether to use the model's prompt optimizer
truefalse
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "hailuo-pro",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "prompt_optimizer": false
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "hailuo-pro",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "prompt_optimizer": false
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "hailuo-pro",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "prompt_optimizer": false
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
hailuo-pro
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
max.1500 characters
 required
input.prompt_optimizer boolean Whether to use the model's prompt optimizer
truefalse
 optional
input.image_url string List of URLs of input images for reference
Max. 1 image
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "hailuo-pro",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "prompt_optimizer": false,
    "image_url": "your_value_here"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "hailuo-pro",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "prompt_optimizer": false,
    "image_url": "your_value_here"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "hailuo-pro",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "prompt_optimizer": false,
    "image_url": "your_value_here"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Video Models Runway
Video

Runway

Model IDrunway
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
runway
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
prompt string The text prompt used to generate the video
max.1800 characters
 required
aspectRatio string Size of the video to be generated
16:94:31:13:49:16
 optional
duration string The duration of the generated video in seconds
5
 required
watermark string Watermark text. Optional parameter If provided, a watermark will be added to the generated video MyBrand optional
quality string Video resolution
720p
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "runway",
  "callBackUrl": "https://your-app.com/webhook",
  "prompt": "your_value_here",
  "aspectRatio": "16:9",
  "duration": "your_value_here",
  "watermark": "your_value_here",
  "quality": "your_value_here"
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "runway",
  "callBackUrl": "https://your-app.com/webhook",
  "prompt": "your_value_here",
  "aspectRatio": "16:9",
  "duration": "your_value_here",
  "watermark": "your_value_here",
  "quality": "your_value_here"
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "runway",
  "callBackUrl": "https://your-app.com/webhook",
  "prompt": "your_value_here",
  "aspectRatio": "16:9",
  "duration": "your_value_here",
  "watermark": "your_value_here",
  "quality": "your_value_here"
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
runway
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
prompt string The text prompt used to generate the video
max.1800 characters
 required
aspectRatio string Size of the video to be generated
16:94:31:13:49:16
 optional
duration string The duration of the generated video in seconds
5
 required
watermark string Watermark text. Optional parameter If provided, a watermark will be added to the generated video MyBrand optional
quality string Video resolution
720p
 required
imageUrl string List of URLs of input images for reference
Max. 1 image
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "runway",
  "callBackUrl": "https://your-app.com/webhook",
  "prompt": "your_value_here",
  "aspectRatio": "16:9",
  "duration": "your_value_here",
  "watermark": "your_value_here",
  "quality": "your_value_here",
  "imageUrl": "your_value_here"
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "runway",
  "callBackUrl": "https://your-app.com/webhook",
  "prompt": "your_value_here",
  "aspectRatio": "16:9",
  "duration": "your_value_here",
  "watermark": "your_value_here",
  "quality": "your_value_here",
  "imageUrl": "your_value_here"
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "runway",
  "callBackUrl": "https://your-app.com/webhook",
  "prompt": "your_value_here",
  "aspectRatio": "16:9",
  "duration": "your_value_here",
  "watermark": "your_value_here",
  "quality": "your_value_here",
  "imageUrl": "your_value_here"
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Video Models Wan 2.2
Video

Wan 2.2

Model IDwan-2-2
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
wan-2-2
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
max.5000 characters
 required
input.resolution string The resolution of the generated video.
480p720p
 required
input.aspect_ratio string Size of the video to be generated
16:99:16
 optional
input.enable_prompt_expansion boolean Whether to enable prompt expansion
truefalse
 optional
input.acceleration string Acceleration level to use.
noneregular
 required
input.seed number Random seed parameter for controlling the randomness of generated content.
Min.10000Max.99999
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan-2-2",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "resolution": "your_value_here",
    "aspect_ratio": "16:9",
    "enable_prompt_expansion": false,
    "acceleration": "your_value_here",
    "seed": 10000
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "wan-2-2",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "resolution": "your_value_here",
    "aspect_ratio": "16:9",
    "enable_prompt_expansion": false,
    "acceleration": "your_value_here",
    "seed": 10000
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "wan-2-2",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "resolution": "your_value_here",
    "aspect_ratio": "16:9",
    "enable_prompt_expansion": false,
    "acceleration": "your_value_here",
    "seed": 10000
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
wan-2-2
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
max.5000 characters
 required
input.resolution string The resolution of the generated video.
480p720p
 required
input.aspect_ratio string Size of the video to be generated
16:99:16
 optional
input.enable_prompt_expansion boolean Whether to enable prompt expansion
truefalse
 optional
input.acceleration string Acceleration level to use.
noneregular
 required
input.seed number Random seed parameter for controlling the randomness of generated content.
Min.10000Max.99999
 optional
input.image_url string List of URLs of input images for reference
Max. 1 image
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan-2-2",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "resolution": "your_value_here",
    "aspect_ratio": "16:9",
    "enable_prompt_expansion": false,
    "acceleration": "your_value_here",
    "seed": 10000,
    "image_url": "your_value_here"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "wan-2-2",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "resolution": "your_value_here",
    "aspect_ratio": "16:9",
    "enable_prompt_expansion": false,
    "acceleration": "your_value_here",
    "seed": 10000,
    "image_url": "your_value_here"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "wan-2-2",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "resolution": "your_value_here",
    "aspect_ratio": "16:9",
    "enable_prompt_expansion": false,
    "acceleration": "your_value_here",
    "seed": 10000,
    "image_url": "your_value_here"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Video Models Kling 2.1
Video

Kling 2.1

Model IDkling-2-1
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
kling-2-1-standardkling-2-1-prokling-2-1-master
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
max.5000 characters
 required
input.duration string The duration of the generated video in seconds
510
 required
input.cfg_scale number The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt
Min: 0Max: 1Step: 0.1
 optional
input.negative_prompt string Elements to avoid in the generated video
Max. 500 characters
 optional
input.image_url string List of URLs of input images for reference
Max. 1 image
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling-2-1-standard",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "duration": "your_value_here",
    "cfg_scale": 0,
    "negative_prompt": "your_value_here",
    "image_url": "your_value_here"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "kling-2-1-standard",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "duration": "your_value_here",
    "cfg_scale": 0,
    "negative_prompt": "your_value_here",
    "image_url": "your_value_here"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "kling-2-1-standard",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "duration": "your_value_here",
    "cfg_scale": 0,
    "negative_prompt": "your_value_here",
    "image_url": "your_value_here"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Video Models Seedance V1
Video

Seedance V1

Model IDseedance-v1
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
seedance-v1-liteseedance-v1-pro
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
max.10000 characters
 required
input.aspect_ratio string Size of the video to be generated
1:14:33:416:99:1621:9
 optional
input.duration string The duration of the generated video in seconds
510
 required
input.resolution string The resolution of the generated video.
480p720p1080p
 required
input.camera_fixed boolean Whether to fix the camera position
truefalse
 optional
input.seed number Random seed parameter for controlling the randomness of generated content.
Min.10000Max.99999
 optional
input.enable_safety_checker boolean Prompt safety checker
truefalse
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedance-v1-lite",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "duration": "your_value_here",
    "resolution": "your_value_here",
    "camera_fixed": false,
    "seed": 10000,
    "enable_safety_checker": true
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "seedance-v1-lite",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "duration": "your_value_here",
    "resolution": "your_value_here",
    "camera_fixed": false,
    "seed": 10000,
    "enable_safety_checker": true
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "seedance-v1-lite",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "duration": "your_value_here",
    "resolution": "your_value_here",
    "camera_fixed": false,
    "seed": 10000,
    "enable_safety_checker": true
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
seedance-v1-liteseedance-v1-pro
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
max.10000 characters
 required
input.aspect_ratio string Size of the video to be generated
1:14:33:416:99:1621:9
 optional
input.duration string The duration of the generated video in seconds
510
 required
input.resolution string The resolution of the generated video.
480p720p1080p
 required
input.camera_fixed boolean Whether to fix the camera position
truefalse
 optional
input.seed number Random seed parameter for controlling the randomness of generated content.
Min.10000Max.99999
 optional
input.enable_safety_checker boolean Prompt safety checker
truefalse
 optional
input.image_url string List of URLs of input images for reference
Max. 1 image
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedance-v1-lite",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "duration": "your_value_here",
    "resolution": "your_value_here",
    "camera_fixed": false,
    "seed": 10000,
    "enable_safety_checker": true,
    "image_url": "your_value_here"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "seedance-v1-lite",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "duration": "your_value_here",
    "resolution": "your_value_here",
    "camera_fixed": false,
    "seed": 10000,
    "enable_safety_checker": true,
    "image_url": "your_value_here"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "seedance-v1-lite",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "duration": "your_value_here",
    "resolution": "your_value_here",
    "camera_fixed": false,
    "seed": 10000,
    "enable_safety_checker": true,
    "image_url": "your_value_here"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Video Models Grok Imagine
Video

Grok Imagine

Model IDgrok-imagine-video
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
grok-imagine-video
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
max.5000 characters
 required
input.aspect_ratio string Size of the video to be generated
1:116:99:162:33:2
 optional
input.mode string Specifies the generation mode affecting the style and intensity of motion.
funnormalspicy
 optional
input.duration string The duration of the generated video (in seconds)
Min: 6Max: 30Step: 1
 required
input.resolution string The resolution of the generated video.
480p720p
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "grok-imagine-video",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "mode": "your_value_here",
    "duration": "your_value_here",
    "resolution": "your_value_here"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "grok-imagine-video",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "mode": "your_value_here",
    "duration": "your_value_here",
    "resolution": "your_value_here"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "grok-imagine-video",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "mode": "your_value_here",
    "duration": "your_value_here",
    "resolution": "your_value_here"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
grok-imagine-video
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
max.5000 characters
 required
input.aspect_ratio string Size of the video to be generated
1:116:99:162:33:2
 optional
input.mode string Specifies the generation mode affecting the style and intensity of motion.
funnormalspicy
 optional
input.duration string The duration of the generated video (in seconds)
Min: 6Max: 30Step: 1
 required
input.resolution string The resolution of the generated video.
480p720p
 required
input.image_urls array List of URLs of input images for reference
Max. 7 images
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "grok-imagine-video",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "mode": "your_value_here",
    "duration": "your_value_here",
    "resolution": "your_value_here",
    "image_urls": ["value"]
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "grok-imagine-video",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "mode": "your_value_here",
    "duration": "your_value_here",
    "resolution": "your_value_here",
    "image_urls": ["value"]
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "grok-imagine-video",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "mode": "your_value_here",
    "duration": "your_value_here",
    "resolution": "your_value_here",
    "image_urls": ["value"]
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Video Models Hailuo 2.3
Video

Hailuo 2.3

Model IDhailuo-2-3
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
hailuo-2-3-standardhailuo-2-3-pro
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
max.5000 characters
 required
input.resolution string The resolution of the generated video.
768P1080P
 required
input.duration string The duration of the generated video (in seconds)
610
 required
input.image_url string List of URLs of input images for reference
Max. 1 image
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "hailuo-2-3-standard",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "resolution": "768P",
    "duration": "6",
    "image_url": "your_value_here"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "hailuo-2-3-standard",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "resolution": "768P",
    "duration": "6",
    "image_url": "your_value_here"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "hailuo-2-3-standard",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "resolution": "768P",
    "duration": "6",
    "image_url": "your_value_here"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Video Models Seedance V1 Pro Fast
Video

Seedance V1 Pro Fast

Model IDseedance-v1-pro-fast
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
seedance-v1-pro-fast
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
max.10000 characters
 required
input.resolution string The resolution of the generated video.
720P1080P
 required
input.duration string The duration of the generated video (in seconds)
510
 required
input.image_url string List of URLs of input images for reference
Max. 1 image
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedance-v1-pro-fast",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "resolution": "720P",
    "duration": "5",
    "image_url": "your_value_here"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "seedance-v1-pro-fast",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "resolution": "720P",
    "duration": "5",
    "image_url": "your_value_here"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "seedance-v1-pro-fast",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "resolution": "720P",
    "duration": "5",
    "image_url": "your_value_here"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Video Models Kling 2.6
Video

Kling 2.6

Model IDkling-2-6
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
kling-2-6
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
max.1000 characters
 required
input.aspect_ratio string Size of the video to be generated
1:116:99:16
 optional
input.duration string The duration of the generated video (in seconds)
510
 required
input.sound boolean This parameter specifies whether the generated video contains sound.
truefalse
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling-2-6",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "duration": "5",
    "sound": false
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "kling-2-6",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "duration": "5",
    "sound": false
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "kling-2-6",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "duration": "5",
    "sound": false
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
kling-2-6
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
max.1000 characters
 required
input.duration string The duration of the generated video (in seconds)
510
 required
input.sound boolean This parameter specifies whether the generated video contains sound.
truefalse
 required
input.image_urls array List of URLs of input images for reference
Max. 1 image
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling-2-6",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "duration": "5",
    "sound": false,
    "image_urls": ["value"]
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "kling-2-6",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "duration": "5",
    "sound": false,
    "image_urls": ["value"]
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "kling-2-6",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "duration": "5",
    "sound": false,
    "image_urls": ["value"]
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Video Models Wan Speech to Video
Video

Wan Speech to Video

Model IDwan-speech-to-video
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
wan-speech-to-video
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
max.5000 characters
 required
input.image_url string List of URLs of input images for reference
Max. 1 image
 required
input.audio_url string List of URLs of audio file URLs
Max. 1 audio
 required
input.num_frames number Number of frames to generate.
Min: 40Max: 120Step: 4
 optional
input.frames_per_second number Frames per second of the generated video.
Min: 4Max: 60Step: 1
 optional
input.resolution string Resolution of the video
480p580p720p
 required
input.negative_prompt string Negative prompt for video generation.
Max 500 characters.
 optional
input.seed number Random seed parameter for controlling the randomness of generated content.
Min.10000Max.99999
 optional
input.num_inference_steps number Number of inference steps for sampling. Higher values give better quality but take longer
Min: 2Max: 40Step: 1
 optional
input.guidance_scale number Classifier-free guidance scale. Higher values give better adherence to the prompt but may decrease quality
Min: 1Max: 10Step: 0.1
 optional
input.shift number Shift value for the video.
Min: 1Max: 10Step: 0.1
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan-speech-to-video",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "image_url": "your_value_here",
    "audio_url": "your_value_here",
    "num_frames": 40,
    "frames_per_second": 4,
    "resolution": "your_value_here",
    "negative_prompt": "your_value_here",
    "seed": 10000,
    "num_inference_steps": 2,
    "guidance_scale": 1,
    "shift": 1
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "wan-speech-to-video",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "image_url": "your_value_here",
    "audio_url": "your_value_here",
    "num_frames": 40,
    "frames_per_second": 4,
    "resolution": "your_value_here",
    "negative_prompt": "your_value_here",
    "seed": 10000,
    "num_inference_steps": 2,
    "guidance_scale": 1,
    "shift": 1
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "wan-speech-to-video",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "image_url": "your_value_here",
    "audio_url": "your_value_here",
    "num_frames": 40,
    "frames_per_second": 4,
    "resolution": "your_value_here",
    "negative_prompt": "your_value_here",
    "seed": 10000,
    "num_inference_steps": 2,
    "guidance_scale": 1,
    "shift": 1
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Video Models Wan Animate
Video

Wan Animate

Model IDwan-animate
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
wan-animate-replacewan-animate-movie
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.image_url string List of URLs of input images for reference
Max. 1 image
 required
input.video_url string List of URLs of input videos for reference
Max. 1 video
 required
input.resolution string Resolution of the video
480p580p720p
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan-animate-replace",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "image_url": "your_value_here",
    "video_url": "your_value_here",
    "resolution": "your_value_here"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "wan-animate-replace",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "image_url": "your_value_here",
    "video_url": "your_value_here",
    "resolution": "your_value_here"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "wan-animate-replace",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "image_url": "your_value_here",
    "video_url": "your_value_here",
    "resolution": "your_value_here"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Video Models Runway Aleph
Video

Runway Aleph

Model IDrunway-aleph
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
runway-aleph
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
prompt string The text prompt used to generate the video
max.1800 characters
 required
videoUrl string List of URLs of input videos for reference
Max. 1 video
 required
waterMark string Watermark text. Optional parameter If provided, a watermark will be added to the generated video MyBrand optional
aspectRatio string Size of the video to be generated
16:99:164:33:41:121:9
 optional
seed string Random seed parameter for controlling the randomness of generated content.
Min.10000Max.99999
 optional
referenceImage string List of URLs of input images for reference
Max. 1 image
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "runway-aleph",
  "callBackUrl": "https://your-app.com/webhook",
  "prompt": "your_value_here",
  "videoUrl": "your_value_here",
  "waterMark": "your_value_here",
  "aspectRatio": "16:9",
  "seed": "your_value_here",
  "referenceImage": "your_value_here"
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "runway-aleph",
  "callBackUrl": "https://your-app.com/webhook",
  "prompt": "your_value_here",
  "videoUrl": "your_value_here",
  "waterMark": "your_value_here",
  "aspectRatio": "16:9",
  "seed": "your_value_here",
  "referenceImage": "your_value_here"
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "runway-aleph",
  "callBackUrl": "https://your-app.com/webhook",
  "prompt": "your_value_here",
  "videoUrl": "your_value_here",
  "waterMark": "your_value_here",
  "aspectRatio": "16:9",
  "seed": "your_value_here",
  "referenceImage": "your_value_here"
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Video Models Wan 2.6
Video

Wan 2.6

Model IDwan-2-6
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
wan-2-6
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
max.5000 characters
 required
input.resolution string Resolution of the video
720p1080p
 required
input.duration string The duration of the generated video (in seconds)
51015
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan-2-6",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "resolution": "your_value_here",
    "duration": "5"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "wan-2-6",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "resolution": "your_value_here",
    "duration": "5"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "wan-2-6",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "resolution": "your_value_here",
    "duration": "5"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
wan-2-6
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
max.5000 characters
 required
input.resolution string Resolution of the video
720p1080p
 required
input.duration string The duration of the generated video (in seconds)
51015
 required
input.image_urls string List of URLs of input images for reference
Max. 1 image
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan-2-6",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "resolution": "your_value_here",
    "duration": "5",
    "image_urls": "your_value_here"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "wan-2-6",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "resolution": "your_value_here",
    "duration": "5",
    "image_urls": "your_value_here"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "wan-2-6",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "resolution": "your_value_here",
    "duration": "5",
    "image_urls": "your_value_here"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Video Models Wan 2.6 Video
Video

Wan 2.6 Video

Model IDwan-2-6-video
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
wan-2-6-video
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
max.5000 characters
 required
input.resolution string Resolution of the video
720p1080p
 required
input.duration string The duration of the generated video (in seconds)
51015
 required
input.video_urls array List of URLs of input videos for reference
Max. 3 Videos
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan-2-6-video",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "resolution": "your_value_here",
    "duration": "5",
    "video_urls": ["value"]
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "wan-2-6-video",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "resolution": "your_value_here",
    "duration": "5",
    "video_urls": ["value"]
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "wan-2-6-video",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "resolution": "your_value_here",
    "duration": "5",
    "video_urls": ["value"]
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Video Models Seedance 1.5 Pro
Video

Seedance 1.5 Pro

Model IDseedance-1-5-pro
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
seedance-1-5-pro
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
max.2500 characters
 required
input.aspect_ratio string Size of the video to be generated
1:14:33:416:99:1621:9
 optional
input.resolution string The resolution of the generated video.
480p720p
 required
input.duration string The duration of the generated video (in seconds)
4812
 required
input.fixed_lens boolean Seedance adds dynamic camera movement. Enable this feature to lock the camera for stable, static shots.
truefalse
 optional
input.generate_audio boolean Whether to generate audio for the video. true: Generate with audio (higher cost)
truefalse
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedance-1-5-pro",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "resolution": "480p",
    "duration": "4",
    "fixed_lens": false,
    "generate_audio": false
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "seedance-1-5-pro",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "resolution": "480p",
    "duration": "4",
    "fixed_lens": false,
    "generate_audio": false
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "seedance-1-5-pro",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "resolution": "480p",
    "duration": "4",
    "fixed_lens": false,
    "generate_audio": false
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
seedance-1-5-pro
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
max.2500 characters
 required
input.aspect_ratio string Size of the video to be generated
1:14:33:416:99:1621:9
 optional
input.resolution string The resolution of the generated video.
480p720p
 required
input.duration string The duration of the generated video (in seconds)
4812
 required
input.fixed_lens boolean Seedance adds dynamic camera movement. Enable this feature to lock the camera for stable, static shots.
truefalse
 optional
input.generate_audio boolean Whether to generate audio for the video. true: Generate with audio (higher cost)
truefalse
 required
input_urls array List of URLs of input videos for reference
Max. 2 Images
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedance-1-5-pro",
  "callBackUrl": "https://your-app.com/webhook",
  "input_urls": ["value"],
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "resolution": "480p",
    "duration": "4",
    "fixed_lens": false,
    "generate_audio": false
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "seedance-1-5-pro",
  "callBackUrl": "https://your-app.com/webhook",
  "input_urls": ["value"],
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "resolution": "480p",
    "duration": "4",
    "fixed_lens": false,
    "generate_audio": false
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "seedance-1-5-pro",
  "callBackUrl": "https://your-app.com/webhook",
  "input_urls": ["value"],
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "1:1",
    "resolution": "480p",
    "duration": "4",
    "fixed_lens": false,
    "generate_audio": false
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Video Models Kling 2.6 Motion Control
Video

Kling 2.6 Motion Control

Model IDkling-2-6-motion
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
kling-2-6-motion
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
max.2500 characters
 required
input.input_urls array List of URLs of input videos for reference
Max. 1 Image
 required
input.video_urls array List of URLs of input videos for reference
Max. 1 Video
 required
input.character_orientation string Generate the orientation of the characters in the video. 'image': same orientation as the person in the picture (max 10s video). 'video': consistent with the orientation of the characters in the video (max 30s video).
imagevideo
 optional
input.mode string Output resolution mode. Use 'std' for 720p or 'pro' for 1080p
stdpro
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling-2-6-motion",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "input_urls": ["value"],
    "video_urls": ["value"],
    "character_orientation": "image",
    "mode": "std"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "kling-2-6-motion",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "input_urls": ["value"],
    "video_urls": ["value"],
    "character_orientation": "image",
    "mode": "std"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "kling-2-6-motion",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "input_urls": ["value"],
    "video_urls": ["value"],
    "character_orientation": "image",
    "mode": "std"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Video Models Kling 3 Motion Control
Video

Kling 3 Motion Control

Model IDkling-3-motion
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
kling-3-motion
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
max.2500 characters
 required
input.input_urls array List of URLs of input videos for reference
Max. 1 Image
 required
input.video_urls array List of URLs of input videos for reference
Max. 1 Video
 required
input.character_orientation string Generate the orientation of the characters in the video. 'image': same orientation as the person in the picture (max 10s video). 'video': consistent with the orientation of the characters in the video (max 30s video).
imagevideo
 optional
input.mode string Output resolution mode. Use 'std' for 720p or 'pro' for 1080p
stdpro
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling-3-motion",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "input_urls": ["value"],
    "video_urls": ["value"],
    "character_orientation": "image",
    "mode": "std"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "kling-3-motion",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "input_urls": ["value"],
    "video_urls": ["value"],
    "character_orientation": "image",
    "mode": "std"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "kling-3-motion",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "input_urls": ["value"],
    "video_urls": ["value"],
    "character_orientation": "image",
    "mode": "std"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Video Models Kling 3.0
Video

Kling 3.0

Model IDkling-3
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
kling-3
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
max.2500 characters
 required
input.mode string Video Generation mode
stdpro4K
 required
input.image_urls array List of URLs of input videos for reference
Max. 1 Image
 required
input.duration string The duration of the generated video in seconds
Min.3Max.15
 required
input.multi_shots boolean Should always be false.
false
 required
input.sound string Whether to enable sound effects. true enables sound effects, false disables them. When multi_shots is true, this field defaults to true.
truefalse
 required
input.aspect_ratio string Video aspect ratio.
1:116:99:16
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling-3",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "mode": "std",
    "image_urls": ["value"],
    "duration": "your_value_here",
    "multi_shots": false,
    "sound": "your_value_here",
    "aspect_ratio": "your_value_here"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "kling-3",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "mode": "std",
    "image_urls": ["value"],
    "duration": "your_value_here",
    "multi_shots": false,
    "sound": "your_value_here",
    "aspect_ratio": "your_value_here"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "kling-3",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "mode": "std",
    "image_urls": ["value"],
    "duration": "your_value_here",
    "multi_shots": false,
    "sound": "your_value_here",
    "aspect_ratio": "your_value_here"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Video Models Kling 3.0 Multi Shot
Video

Kling 3.0 Multi Shot

Model IDkling-3-multi-shot
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
kling-3-multi-shot
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.multi_prompt string The text prompt used to generate the video
max.5000 characters
 required
input.mode string Video Generation mode
stdpro4K
 required
input.image_urls array List of URLs of input videos for reference
Max. 3 Images
 required
input.duration string The duration of the generated video in seconds
Min.3Max.15
 required
input.multi_shots boolean Should always be true.
true
 required
input.aspect_ratio string Video aspect ratio.
1:116:99:16
 optional
input.kling_elements array Referenced elements. Detailed information about elements referenced in the prompt. A single task can reference a maximum of three elements. Max.3 Elements
Referer code samples below for format
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling-3-multi-shot",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "multi_prompt": "your_value_here",
    "mode": "std",
    "image_urls": ["value"],
    "duration": "your_value_here",
    "multi_shots": false,
    "aspect_ratio": "your_value_here",
    "kling_elements": [{"name":"element_dog","description":"dog","element_input_urls":["https://example.com/img.jpg"]}]
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "kling-3-multi-shot",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "multi_prompt": "your_value_here",
    "mode": "std",
    "image_urls": ["value"],
    "duration": "your_value_here",
    "multi_shots": false,
    "aspect_ratio": "your_value_here",
    "kling_elements": [{"name":"element_dog","description":"dog","element_input_urls":["https://example.com/img.jpg"]}]
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "kling-3-multi-shot",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "multi_prompt": "your_value_here",
    "mode": "std",
    "image_urls": ["value"],
    "duration": "your_value_here",
    "multi_shots": false,
    "aspect_ratio": "your_value_here",
    "kling_elements": [{"name":"element_dog","description":"dog","element_input_urls":["https://example.com/img.jpg"]}]
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Video Models Wan 2.7 Video
Video

Wan 2.7 Video

Model IDwan-2-7-video
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
wan-2-7-video
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
max.5000 characters
 required
input.resolution string Video resolution.
720p1080p
 required
input.seed number Random seed parameter for controlling the randomness of generated content.
Min.10000Max.99999
 optional
input.prompt_extend boolean Whether to enable intelligent prompt rewriting.
truefalse
 optional
input.duration number The duration of the generated video in seconds
Min.3Max.15
 required
input.ratio string Video aspect ratio.
16:99:161:14:33:4
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan-2-7-video",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "resolution": "your_value_here",
    "seed": 10000,
    "prompt_extend": false,
    "duration": 10000,
    "ratio": "your_value_here"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "wan-2-7-video",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "resolution": "your_value_here",
    "seed": 10000,
    "prompt_extend": false,
    "duration": 10000,
    "ratio": "your_value_here"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "wan-2-7-video",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "resolution": "your_value_here",
    "seed": 10000,
    "prompt_extend": false,
    "duration": 10000,
    "ratio": "your_value_here"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
wan-2-7-video
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
max.5000 characters
 required
input.resolution string Video resolution.
720p1080p
 required
input.seed number Random seed parameter for controlling the randomness of generated content.
Min.10000Max.99999
 optional
input.prompt_extend boolean Whether to enable intelligent prompt rewriting.
truefalse
 optional
input.duration number The duration of the generated video in seconds
Min.3Max.15
 required
input.ratio string Video aspect ratio.
16:99:161:14:33:4
 optional
input.first_frame_url string List of URLs of input videos for reference
Max. 1 Image
 required
input.last_frame_url string List of URLs of input videos for reference
Max. 1 Image
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan-2-7-video",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "resolution": "your_value_here",
    "seed": 10000,
    "prompt_extend": false,
    "duration": 10000,
    "ratio": "your_value_here",
    "first_frame_url": "your_value_here",
    "last_frame_url": "your_value_here"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "wan-2-7-video",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "resolution": "your_value_here",
    "seed": 10000,
    "prompt_extend": false,
    "duration": 10000,
    "ratio": "your_value_here",
    "first_frame_url": "your_value_here",
    "last_frame_url": "your_value_here"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "wan-2-7-video",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "resolution": "your_value_here",
    "seed": 10000,
    "prompt_extend": false,
    "duration": 10000,
    "ratio": "your_value_here",
    "first_frame_url": "your_value_here",
    "last_frame_url": "your_value_here"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Video Models Seedance 2 Fast
Video

Seedance 2 Fast

Model IDseedance-2-fast
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
seedance-2-fast
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
max.20000 characters
 required
input.aspect_ratio string Video aspect ratio.
1:14:33:416:99:1621:9adaptive
 optional
input.resolution string Video resolution
480p720p1080p
 required
input.duration string Duration of the video
Min.4Max.15
 required
input.web_search boolean Use online search
truefalse
 optional
input.generate_audio boolean Whether to generate audio for the video
truefalse
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedance-2-fast",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "your_value_here",
    "resolution": "480p",
    "duration": "your_value_here",
    "web_search": true,
    "generate_audio": false
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "seedance-2-fast",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "your_value_here",
    "resolution": "480p",
    "duration": "your_value_here",
    "web_search": true,
    "generate_audio": false
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "seedance-2-fast",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "your_value_here",
    "resolution": "480p",
    "duration": "your_value_here",
    "web_search": true,
    "generate_audio": false
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
seedance-2-fast
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
max.20000 characters
 required
input.aspect_ratio string Video aspect ratio.
1:14:33:416:99:1621:9adaptive
 optional
input.resolution string Video resolution
480p720p1080p
 required
input.duration string Duration of the video
Min.4Max.15
 required
input.web_search boolean Use online search
truefalse
 optional
input.generate_audio boolean Whether to generate audio for the video
truefalse
 required
input.first_frame_url string List of URLs of input videos for reference
Max. 1 Image
 required
input.last_frame_url string List of URLs of input image for reference
Max. 1 Image
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedance-2-fast",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "your_value_here",
    "resolution": "480p",
    "duration": "your_value_here",
    "web_search": true,
    "generate_audio": false,
    "first_frame_url": "your_value_here",
    "last_frame_url": "your_value_here"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "seedance-2-fast",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "your_value_here",
    "resolution": "480p",
    "duration": "your_value_here",
    "web_search": true,
    "generate_audio": false,
    "first_frame_url": "your_value_here",
    "last_frame_url": "your_value_here"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "seedance-2-fast",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "your_value_here",
    "resolution": "480p",
    "duration": "your_value_here",
    "web_search": true,
    "generate_audio": false,
    "first_frame_url": "your_value_here",
    "last_frame_url": "your_value_here"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
seedance-2-fast
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
Use @Image1 @Video1 @Audio1 to reference the attached files inbetween your prompt
max.20000 characters
 required
input.aspect_ratio string Video aspect ratio.
1:14:33:416:99:1621:9adaptive
 optional
input.resolution string Video resolution
480p720p1080p
 required
input.duration string Duration of the video
Min.4Max.15
 required
input.generate_audio boolean Whether to generate audio for the video
truefalse
 required
input.reference_image_urls array List of URLs of input images for reference
Max. 3 Images
 required
input.reference_video_urls array List of URLs of input videos for reference
Max. 3 Videos
 optional
input.reference_audio_urls array List of URLs of input audios for reference
Max. 3 Audios
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedance-2-fast",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "Use @Image1 @Video1 @Audio1 to reference the attached files inbetween your prompt",
    "aspect_ratio": "your_value_here",
    "resolution": "480p",
    "duration": "your_value_here",
    "generate_audio": false,
    "reference_image_urls": ["value"],
    "reference_video_urls": ["value"],
    "reference_audio_urls": ["value"]
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "seedance-2-fast",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "Use @Image1 @Video1 @Audio1 to reference the attached files inbetween your prompt",
    "aspect_ratio": "your_value_here",
    "resolution": "480p",
    "duration": "your_value_here",
    "generate_audio": false,
    "reference_image_urls": ["value"],
    "reference_video_urls": ["value"],
    "reference_audio_urls": ["value"]
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "seedance-2-fast",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "Use @Image1 @Video1 @Audio1 to reference the attached files inbetween your prompt",
    "aspect_ratio": "your_value_here",
    "resolution": "480p",
    "duration": "your_value_here",
    "generate_audio": false,
    "reference_image_urls": ["value"],
    "reference_video_urls": ["value"],
    "reference_audio_urls": ["value"]
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Video Models Seedance 2
Video

Seedance 2

Model IDseedance-2
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
seedance-2-fast
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
max.20000 characters
 required
input.aspect_ratio string Video aspect ratio.
1:14:33:416:99:1621:9adaptive
 optional
input.resolution string Video resolution
480p720p1080p
 required
input.duration string Duration of the video
Min.4Max.15
 required
input.web_search boolean Use online search
truefalse
 optional
input.generate_audio boolean Whether to generate audio for the video
truefalse
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedance-2-fast",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "your_value_here",
    "resolution": "480p",
    "duration": "your_value_here",
    "web_search": true,
    "generate_audio": false
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "seedance-2-fast",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "your_value_here",
    "resolution": "480p",
    "duration": "your_value_here",
    "web_search": true,
    "generate_audio": false
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "seedance-2-fast",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "your_value_here",
    "resolution": "480p",
    "duration": "your_value_here",
    "web_search": true,
    "generate_audio": false
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
seedance-2-fast
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
Use @Image1 @Video1 @Audio1 to reference the attached files inbetween your prompt
max.20000 characters
 required
input.aspect_ratio string Video aspect ratio.
1:14:33:416:99:1621:9adaptive
 optional
input.resolution string Video resolution
480p720p1080p
 required
input.duration string Duration of the video
Min.4Max.15
 required
input.generate_audio boolean Whether to generate audio for the video
truefalse
 required
input.reference_image_urls array List of URLs of input images for reference
Max. 3 Images
 required
input.reference_video_urls array List of URLs of input videos for reference
Max. 3 Videos
 optional
input.reference_audio_urls array List of URLs of input audios for reference
Max. 3 Audios
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedance-2-fast",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "Use @Image1 @Video1 @Audio1 to reference the attached files inbetween your prompt",
    "aspect_ratio": "your_value_here",
    "resolution": "480p",
    "duration": "your_value_here",
    "generate_audio": false,
    "reference_image_urls": ["value"],
    "reference_video_urls": ["value"],
    "reference_audio_urls": ["value"]
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "seedance-2-fast",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "Use @Image1 @Video1 @Audio1 to reference the attached files inbetween your prompt",
    "aspect_ratio": "your_value_here",
    "resolution": "480p",
    "duration": "your_value_here",
    "generate_audio": false,
    "reference_image_urls": ["value"],
    "reference_video_urls": ["value"],
    "reference_audio_urls": ["value"]
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "seedance-2-fast",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "Use @Image1 @Video1 @Audio1 to reference the attached files inbetween your prompt",
    "aspect_ratio": "your_value_here",
    "resolution": "480p",
    "duration": "your_value_here",
    "generate_audio": false,
    "reference_image_urls": ["value"],
    "reference_video_urls": ["value"],
    "reference_audio_urls": ["value"]
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
seedance-2-fast
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
max.20000 characters
 required
input.aspect_ratio string Video aspect ratio.
1:14:33:416:99:1621:9adaptive
 optional
input.resolution string Video resolution
480p720p1080p
 required
input.duration string Duration of the video
Min.4Max.15
 required
input.web_search boolean Use online search
truefalse
 optional
input.generate_audio boolean Whether to generate audio for the video
truefalse
 required
input.first_frame_url string List of URLs of input videos for reference
Max. 1 Image
 required
input.last_frame_url string List of URLs of input image for reference
Max. 1 Image
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedance-2-fast",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "your_value_here",
    "resolution": "480p",
    "duration": "your_value_here",
    "web_search": true,
    "generate_audio": false,
    "first_frame_url": "your_value_here",
    "last_frame_url": "your_value_here"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "seedance-2-fast",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "your_value_here",
    "resolution": "480p",
    "duration": "your_value_here",
    "web_search": true,
    "generate_audio": false,
    "first_frame_url": "your_value_here",
    "last_frame_url": "your_value_here"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "seedance-2-fast",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "your_value_here",
    "resolution": "480p",
    "duration": "your_value_here",
    "web_search": true,
    "generate_audio": false,
    "first_frame_url": "your_value_here",
    "last_frame_url": "your_value_here"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Video Models HappyHorse 1.0
Video

HappyHorse 1.0

Model IDhappyhorse-1
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
happyhorse-1
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
max.5000 characters
 required
input.resolution string Video resolution
720p1080p
 required
input.seed number Random seed parameter for controlling the randomness of generated content.
Min.10000Max.99999
 optional
input.duration number Duration of the video
51015
 required
input.aspect_ratio string Video aspect ratio.
1:14:33:416:99:16
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "happyhorse-1",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "resolution": "720p",
    "seed": 10000,
    "duration": 10000,
    "aspect_ratio": "your_value_here"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "happyhorse-1",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "resolution": "720p",
    "seed": 10000,
    "duration": 10000,
    "aspect_ratio": "your_value_here"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "happyhorse-1",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "resolution": "720p",
    "seed": 10000,
    "duration": 10000,
    "aspect_ratio": "your_value_here"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
happyhorse-1
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.prompt string The text prompt used to generate the video
max.5000 characters
 required
input.resolution string Video resolution
720p1080p
 required
input.seed number Random seed parameter for controlling the randomness of generated content.
Min.10000Max.99999
 optional
input.duration number Duration of the video
51015
 required
input.aspect_ratio string Video aspect ratio.
1:14:33:416:99:16
 optional
input.image_urls array List of URLs of input images for reference
Max. 1 Image
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "happyhorse-1",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "resolution": "720p",
    "seed": 10000,
    "duration": 10000,
    "aspect_ratio": "your_value_here",
    "image_urls": ["value"]
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "happyhorse-1",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "resolution": "720p",
    "seed": 10000,
    "duration": 10000,
    "aspect_ratio": "your_value_here",
    "image_urls": ["value"]
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "happyhorse-1",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "prompt": "your_value_here",
    "resolution": "720p",
    "seed": 10000,
    "duration": 10000,
    "aspect_ratio": "your_value_here",
    "image_urls": ["value"]
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Video Models Vidu Q3 Pro
Video

Vidu Q3 Pro

Model IDvidu-q3-pro
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
vidu-q3-pro
 required
input.prompt string The text prompt used to generate the video
max.5000 characters
 required
input.aspect_ratio string Video aspect ratio.
1:116:99:164:33:4
 optional
input.resolution string Video resolution
540p720p1080p
 required
input.duration number Duration of the video
51015
 required
generate_audio boolean Generate Audio with video
truefalse
 required
input.bgm boolean Generate BGM with video
truefalse
 optional
input.seed number Random seed parameter for controlling the randomness of generated content.
Min.10000Max.99999
 optional
input.style string Style of the video.
GeneralAnime
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "vidu-q3-pro",
  "generate_audio": true,
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "your_value_here",
    "resolution": "540p",
    "duration": 10000,
    "bgm": true,
    "seed": 10000,
    "style": "General"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "vidu-q3-pro",
  "generate_audio": true,
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "your_value_here",
    "resolution": "540p",
    "duration": 10000,
    "bgm": true,
    "seed": 10000,
    "style": "General"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "vidu-q3-pro",
  "generate_audio": true,
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "your_value_here",
    "resolution": "540p",
    "duration": 10000,
    "bgm": true,
    "seed": 10000,
    "style": "General"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
vidu-q3-pro
 required
input.prompt string The text prompt used to generate the video
max.5000 characters
 required
input.aspect_ratio string Video aspect ratio.
1:116:99:164:33:4
 optional
input.resolution string Video resolution
540p720p1080p
 required
input.duration number Duration of the video
51015
 required
generate_audio boolean Generate Audio with video
truefalse
 required
input.bgm boolean Generate BGM with video
truefalse
 optional
input.seed number Random seed parameter for controlling the randomness of generated content.
Min.10000Max.99999
 optional
input.style string Style of the video.
GeneralAnime
 required
input.image array List of URLs of input images for reference
Max. 2 Images
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "vidu-q3-pro",
  "generate_audio": true,
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "your_value_here",
    "resolution": "540p",
    "duration": 10000,
    "bgm": true,
    "seed": 10000,
    "style": "General",
    "image": ["value"]
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "vidu-q3-pro",
  "generate_audio": true,
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "your_value_here",
    "resolution": "540p",
    "duration": 10000,
    "bgm": true,
    "seed": 10000,
    "style": "General",
    "image": ["value"]
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "vidu-q3-pro",
  "generate_audio": true,
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "your_value_here",
    "resolution": "540p",
    "duration": 10000,
    "bgm": true,
    "seed": 10000,
    "style": "General",
    "image": ["value"]
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Video Models Vidu Q3 Turbo
Video

Vidu Q3 Turbo

Model IDvidu-q3-turbo
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
vidu-q3-turbo
 required
input.prompt string The text prompt used to generate the video
max.5000 characters
 required
input.aspect_ratio string Video aspect ratio.
1:116:99:164:33:4
 optional
input.resolution string Video resolution
540p720p1080p
 required
input.duration number Duration of the video
51015
 required
generate_audio boolean Generate Audio with video
truefalse
 required
input.bgm boolean Generate BGM with video
truefalse
 optional
input.seed number Random seed parameter for controlling the randomness of generated content.
Min.10000Max.99999
 optional
input.style string Style of the video.
GeneralAnime
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "vidu-q3-turbo",
  "generate_audio": true,
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "your_value_here",
    "resolution": "540p",
    "duration": 10000,
    "bgm": true,
    "seed": 10000,
    "style": "General"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "vidu-q3-turbo",
  "generate_audio": true,
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "your_value_here",
    "resolution": "540p",
    "duration": 10000,
    "bgm": true,
    "seed": 10000,
    "style": "General"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "vidu-q3-turbo",
  "generate_audio": true,
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "your_value_here",
    "resolution": "540p",
    "duration": 10000,
    "bgm": true,
    "seed": 10000,
    "style": "General"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
vidu-q3-turbo
 required
input.prompt string The text prompt used to generate the video
max.5000 characters
 required
input.aspect_ratio string Video aspect ratio.
1:116:99:164:33:4
 optional
input.resolution string Video resolution
540p720p1080p
 required
input.duration number Duration of the video
51015
 required
generate_audio boolean Generate Audio with video
truefalse
 required
input.bgm boolean Generate BGM with video
truefalse
 optional
input.seed number Random seed parameter for controlling the randomness of generated content.
Min.10000Max.99999
 optional
input.style string Style of the video.
GeneralAnime
 required
input.image array List of URLs of input images for reference
Max. 2 Images
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "vidu-q3-turbo",
  "generate_audio": true,
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "your_value_here",
    "resolution": "540p",
    "duration": 10000,
    "bgm": true,
    "seed": 10000,
    "style": "General",
    "image": ["value"]
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "vidu-q3-turbo",
  "generate_audio": true,
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "your_value_here",
    "resolution": "540p",
    "duration": 10000,
    "bgm": true,
    "seed": 10000,
    "style": "General",
    "image": ["value"]
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "vidu-q3-turbo",
  "generate_audio": true,
  "input": {
    "prompt": "your_value_here",
    "aspect_ratio": "your_value_here",
    "resolution": "540p",
    "duration": 10000,
    "bgm": true,
    "seed": 10000,
    "style": "General",
    "image": ["value"]
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Audio Models ElevenLabs TTS Turbo
Audio

ElevenLabs TTS Turbo

Model IDelevenlabs-tts
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
elevenlabs-tts-turbo
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.text string The text prompt used to text to speech
max.5000 characters
 required
input.voice string The voice to use for speech generation.
RachelAriaRogerSarahLauraCharlieGeorgeCallumRiverLiamCharlotteAliceMatildaWillJessicaEricChrisBrianDanielLilyBillBIvP0GN1cAtSRTxNHnWSaMSt68OGf4xUZAnLpTU8RILOU7YmBhvwJGDGjNmPEkK5I93UQWFDigLMpZcXZ3R5wn05IrDiVCyEkUrKtnSpp4vdxKPjI9w0GnoVNNl6r8mD7vthiJatiJt1YOq2y2Up4RgXP2HyXjE5Bj9UqZbhQsanLzgalpEGc6SfcYrb2t09NHXiT80TB8gJV1IhpuegLxdpXFOEexsUS4vynmxd379XN4yOBpjGufoPiobT79j2vtj42zRM7PkgwBPiau2jvVXc1SM7GgM6IMuvQlz2BwM35l5f8iK3YPeGga21rQIXscOwDtmlUjD3prqpp97INOpBlnGInO9m6vDvFkFCBZgkqPqms7Kj9ulSkVznwo6udizrrtpIxWGp2qJkgU0LNdkMOQCOrPrwtbeeDGzg6RaUqxGRTHSBjfgFDGTOOUoGpoP6UZ9uSWfAx70vRnQBMBu4FAYhjJbOP1bg08DkjqiVEzOn76yGqDuRKMlYmrm8trt5QyBnqXpMhyvQqiRxWQs4qSSBTX3LPaxmHKxFdv7VOQHJiP95p4xoKVk53GoZ742BSOYHLrjzK2X1ezoPC6crN2lVS1w4EtoT3dr4eOWOFGY2WhTYpPnrIDTdsKH5cgSgspJ2msm6clMCkdW9kPzsL2i3teMYv0FxEYQ6UgBBYS2sOqTuMpoF3BR0hpp4J3VqNfWAUOO0d1UspNInz6obpgDQGcFmaJgBnPczCjzI2devNBz1zQrbuYXf8XasLslADfZ2MB4ugs0tAILXbY5DNrJrsM6FDTKMou8ccj1ZaWGBiotdvBKc2FfBKJfcZNyEt1n6DYkrAHD8iwork3YSUBbs56AoDkrOh6qfVPDXZ7PteR40ATw9ArzDf9h3v7t7g6xIsTj2HwM6VR4iXFCwlcMyyd2HUfFzxdCaC4Ta6aDn1KB0hjpdcocrUkmqSq93GQT4X1lKDXsQcixOflHkNRp1BlvT73UL6gyz9yzdeviXkFddZ4Oz8MokpPdl9cQBQq4p6mRkZy2ZzYcjlYFOd3taleS0gkk3nzeAacJi50IvxcyDnMXaruirxsoakN0GWmGNIo04TC0Zp7WVFzhA8zpTlRqVljo9gAlSqKOvF6D8sOsXPPzYpIqttlTYA83688JIZF6FPAbjXT4488VcRRnw8JVbfL6oEdmuxKn5DK2CiCrDUkL56s3C8sCRl7wb1hlpeD1ydbI2ow0Tt3EWwJqPPQ618aTW29mptyocEiNlNiXeDU1pqqOPrYMO4YYIPFl9wE5c4L2eu2Gb6F5Zhi321D3Oq7v1oNT4YXpFCvM1S3JbWEJhoskWLG95yZDEHg6fCZdQjLqjCeNX9CMwmxDxUF5Q2Inmst7NwhTPEzqo2riw7qWCaD6riP1btT197c6dACmymtrellq69YZsNwzUSyXhdHd5gvgSOzSfduK4CvEgeVItLK1UvXctxuaRV2Oqesy0r39YPLQjOczyOib8Tsns2HvNFKfGiNjllgqo1U02n4nD6AdIZ9CjF053AeRdCCKzvd23BpJoofzxLruHrtVF6PSyGItzMNHSQggl4b0xRMiqOwhPtVWTzA6D7RyKdc2EClouEMkP1wGbFxmAM3Fgw63G1zZJhqfrgApggtO1785R4FsnMJ0RnG71ty4LH3dvNfSd
 required
input.stability number Voice stability parameter
00.51
 optional
input.style number Style exaggeration
Min: 0Max: 1Step: 0.01
 optional
input.speed number Speech speed.Extreme values may affect quality.
Min: 0.7Max: 1.2Step: 0.01
 optional
input.similarity_boost number Similarity boost
Min: 0Max: 1Step: 0.01
 optional
input.language_code string Language code for the speech. Default is empty string or omit the parameter for automatic language detection.
afarhyasazbebnbsbgcacebnyhrcsdanlenetfilfifrglkadeelguhahehihuisidgaitjajvknkkkykolvlnltlbmkmsmlzhmrnenopsfaplptparorusrsdskslsoesswsvtatethtrukurvicy
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "elevenlabs-tts-turbo",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "text": "your_value_here",
    "voice": "your_value_here",
    "stability": 10000,
    "style": 0,
    "speed": 0,
    "similarity_boost": 0,
    "language_code": "your_value_here"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "elevenlabs-tts-turbo",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "text": "your_value_here",
    "voice": "your_value_here",
    "stability": 10000,
    "style": 0,
    "speed": 0,
    "similarity_boost": 0,
    "language_code": "your_value_here"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "elevenlabs-tts-turbo",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "text": "your_value_here",
    "voice": "your_value_here",
    "stability": 10000,
    "style": 0,
    "speed": 0,
    "similarity_boost": 0,
    "language_code": "your_value_here"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Audio Models ElevenLabs TTS Multi Lang
Audio

ElevenLabs TTS Multi Lang

Model IDelevenlabs-tts-turbo
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
elevenlabs-tts
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.text string The text prompt used to text to speech
max.5000 characters
 required
input.voice string The voice to use for speech generation.
RachelAriaRogerSarahLauraCharlieGeorgeCallumRiverLiamCharlotteAliceMatildaWillJessicaEricChrisBrianDanielLilyBillBIvP0GN1cAtSRTxNHnWSaMSt68OGf4xUZAnLpTU8RILOU7YmBhvwJGDGjNmPEkK5I93UQWFDigLMpZcXZ3R5wn05IrDiVCyEkUrKtnSpp4vdxKPjI9w0GnoVNNl6r8mD7vthiJatiJt1YOq2y2Up4RgXP2HyXjE5Bj9UqZbhQsanLzgalpEGc6SfcYrb2t09NHXiT80TB8gJV1IhpuegLxdpXFOEexsUS4vynmxd379XN4yOBpjGufoPiobT79j2vtj42zRM7PkgwBPiau2jvVXc1SM7GgM6IMuvQlz2BwM35l5f8iK3YPeGga21rQIXscOwDtmlUjD3prqpp97INOpBlnGInO9m6vDvFkFCBZgkqPqms7Kj9ulSkVznwo6udizrrtpIxWGp2qJkgU0LNdkMOQCOrPrwtbeeDGzg6RaUqxGRTHSBjfgFDGTOOUoGpoP6UZ9uSWfAx70vRnQBMBu4FAYhjJbOP1bg08DkjqiVEzOn76yGqDuRKMlYmrm8trt5QyBnqXpMhyvQqiRxWQs4qSSBTX3LPaxmHKxFdv7VOQHJiP95p4xoKVk53GoZ742BSOYHLrjzK2X1ezoPC6crN2lVS1w4EtoT3dr4eOWOFGY2WhTYpPnrIDTdsKH5cgSgspJ2msm6clMCkdW9kPzsL2i3teMYv0FxEYQ6UgBBYS2sOqTuMpoF3BR0hpp4J3VqNfWAUOO0d1UspNInz6obpgDQGcFmaJgBnPczCjzI2devNBz1zQrbuYXf8XasLslADfZ2MB4ugs0tAILXbY5DNrJrsM6FDTKMou8ccj1ZaWGBiotdvBKc2FfBKJfcZNyEt1n6DYkrAHD8iwork3YSUBbs56AoDkrOh6qfVPDXZ7PteR40ATw9ArzDf9h3v7t7g6xIsTj2HwM6VR4iXFCwlcMyyd2HUfFzxdCaC4Ta6aDn1KB0hjpdcocrUkmqSq93GQT4X1lKDXsQcixOflHkNRp1BlvT73UL6gyz9yzdeviXkFddZ4Oz8MokpPdl9cQBQq4p6mRkZy2ZzYcjlYFOd3taleS0gkk3nzeAacJi50IvxcyDnMXaruirxsoakN0GWmGNIo04TC0Zp7WVFzhA8zpTlRqVljo9gAlSqKOvF6D8sOsXPPzYpIqttlTYA83688JIZF6FPAbjXT4488VcRRnw8JVbfL6oEdmuxKn5DK2CiCrDUkL56s3C8sCRl7wb1hlpeD1ydbI2ow0Tt3EWwJqPPQ618aTW29mptyocEiNlNiXeDU1pqqOPrYMO4YYIPFl9wE5c4L2eu2Gb6F5Zhi321D3Oq7v1oNT4YXpFCvM1S3JbWEJhoskWLG95yZDEHg6fCZdQjLqjCeNX9CMwmxDxUF5Q2Inmst7NwhTPEzqo2riw7qWCaD6riP1btT197c6dACmymtrellq69YZsNwzUSyXhdHd5gvgSOzSfduK4CvEgeVItLK1UvXctxuaRV2Oqesy0r39YPLQjOczyOib8Tsns2HvNFKfGiNjllgqo1U02n4nD6AdIZ9CjF053AeRdCCKzvd23BpJoofzxLruHrtVF6PSyGItzMNHSQggl4b0xRMiqOwhPtVWTzA6D7RyKdc2EClouEMkP1wGbFxmAM3Fgw63G1zZJhqfrgApggtO1785R4FsnMJ0RnG71ty4LH3dvNfSd
 required
input.stability number Voice stability parameter
00.51
 optional
input.style number Style exaggeration
Min: 0Max: 1Step: 0.01
 optional
input.speed number Speech speed.Extreme values may affect quality.
Min: 0.7Max: 1.2Step: 0.01
 optional
input.similarity_boost number Similarity boost
Min: 0Max: 1Step: 0.01
 optional
input.language_code string Language code for the speech. Default is empty string or omit the parameter for automatic language detection.
afarhyasazbebnbsbgcacebnyhrcsdanlenetfilfifrglkadeelguhahehihuisidgaitjajvknkkkykolvlnltlbmkmsmlzhmrnenopsfaplptparorusrsdskslsoesswsvtatethtrukurvicy
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "elevenlabs-tts",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "text": "your_value_here",
    "voice": "your_value_here",
    "stability": 10000,
    "style": 0,
    "speed": 0,
    "similarity_boost": 0,
    "language_code": "your_value_here"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "elevenlabs-tts",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "text": "your_value_here",
    "voice": "your_value_here",
    "stability": 10000,
    "style": 0,
    "speed": 0,
    "similarity_boost": 0,
    "language_code": "your_value_here"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "elevenlabs-tts",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "text": "your_value_here",
    "voice": "your_value_here",
    "stability": 10000,
    "style": 0,
    "speed": 0,
    "similarity_boost": 0,
    "language_code": "your_value_here"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Audio Models Elevenlabs Speech to Text
Audio

Elevenlabs Speech to Text

Model IDelevenlabs-speech-to-text
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
elevenlabs-speech-to-text
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.audio_url string URL of the audio file to transcribe.
Max. 1 Audio file
 required
input.language_code string Language code of the audio.
afarhyasazbebnbsbgcacebnyhrcsdanlenetfilfifrglkadeelguhahehihuisidgaitjajvknkkkykolvlnltlbmkmsmlzhmrnenopsfaplptparorusrsdskslsoesswsvtatethtrukurvicy
 optional
input.tag_audio_events boolean Tag audio events like laughter, applause, etc.
truefalse
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "elevenlabs-speech-to-text",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "audio_url": "Max. 1 Audio file",
    "language_code": "your_value_here",
    "tag_audio_events": true
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "elevenlabs-speech-to-text",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "audio_url": "Max. 1 Audio file",
    "language_code": "your_value_here",
    "tag_audio_events": true
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "elevenlabs-speech-to-text",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "audio_url": "Max. 1 Audio file",
    "language_code": "your_value_here",
    "tag_audio_events": true
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Audio Models Elevenlabs Audio Isolation
Audio

Elevenlabs Audio Isolation

Model IDelevenlabs-audio-isolation
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
elevenlabs-audio-isolation
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.audio_url string URL of the audio file to transcribe.
Max. 1 Audio file
 required
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "elevenlabs-audio-isolation",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "audio_url": "Max. 1 Audio file"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "elevenlabs-audio-isolation",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "audio_url": "Max. 1 Audio file"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "elevenlabs-audio-isolation",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "audio_url": "Max. 1 Audio file"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Audio Models Elevenlabs Sound Effect
Audio

Elevenlabs Sound Effect

Model IDelevenlabs-sound-effect
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
elevenlabs-sound-effect
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.text string The text describing the sound effect to generate.
max.5000 characters
 required
input.duration_seconds number Duration in seconds
Min: 0.5Max: 22Step: 0.1
 required
input.prompt_influence number How closely to follow the prompt.
Min: 0Max: 1Step: 0.01
 optional
input.loop boolean Whether to create a sound effect that loops smoothly.
truefalse
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "elevenlabs-sound-effect",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "text": "your_value_here",
    "duration_seconds": 0,
    "prompt_influence": 0,
    "loop": false
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "elevenlabs-sound-effect",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "text": "your_value_here",
    "duration_seconds": 0,
    "prompt_influence": 0,
    "loop": false
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "elevenlabs-sound-effect",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "text": "your_value_here",
    "duration_seconds": 0,
    "prompt_influence": 0,
    "loop": false
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}
API Reference Audio Models Elevenlabs V3 Dialogue
Audio

Elevenlabs V3 Dialogue

Model IDelevenlabs-v3-dialogue
Endpoint
POSThttps://business.api.cliprise.app/app/cliprise/generate
Headers
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json
Body parameters
ParameterTypeDescription
model string The model name to use for generation.
elevenlabs-v3-dialogue
 required
callBackUrl string POST webhook URL to receive task completion. Recommended for production. optional
input.dialogue array Array of dialogue items. Each item contains text and voice. Ref.Code samples below
Max. 5000 characters combined.Voices listed below
EkK5I93UQWFDigLMpZcXZ3R5wn05IrDiVCyEkUrKNNl6r8mD7vthiJatiJt1YOq2y2Up4RgXP2HyXjE5B8gJV1IhpuegLxdpXFOE2zRM7PkgwBPiau2jvVXc1SM7GgM6IMuvQlz2BwM35l5f8iK3YPeGga21rQIXscOwDtmlUjD3prqpp97INOpBlnGInO9m6vDvFkFCBZgkqPqms7Kj9ulSkVznwo6udizrrtpIxWGp2qJkgU0LNdkMOQCOrPrwtbeeDGzg6RaUqxGRTHSBjfgFx70vRnQBMBu4FAYhjJbOSm1seazb4gs7RSlUVw7cP1bg08DkjqiVEzOn76yGqDuRKMlYmrm8trt5QyBnqXpMhyvQqiRxWQs4qSSBTX3LPaxmHKxFdv7VOQHJN2lVS1w4EtoT3dr4eOWOFGY2WhTYpPnrIDTdsKH5kPzsL2i3teMYv0FxEYQ6UgBBYS2sOqTuMpoF3BR0hpp4J3VqNfWAUOO0d1UsnPczCjzI2devNBz1zQrbuYXf8XasLslADfZ2MB4ugs0tAILXbY5DNrJrsM6FDTKMou8ccj1ZaWGBiotdvBKc2FfBKJfcZNyEt1n6DYkrAHD8iwork3YSUBbs56AoDkrOh6qfVPDXZ7PteR40ATw9ArzDf9h3v7t7g6xIsTj2HwM6VR4iXFCwlcMyyd2HUfFzxdCaC4Ta6aDn1KB0hjpdcocrUkmqSq93GQT4X1lKDXsQcixOflHkNRp1BlvT73UL6gyz9yzdeviXkFddZ4Oz8MokpPdl9cQBQq4p6mRkZy2ZzYcjlYFOd3taleS0gkk3nzeAacJi50IvxcyDnMXaruirxsoakN0GWmGNIo04TC0Zp7WVFzhA8zpTlRqVljo9gAlSqKOvF6D8sOsXPPzYpIqttlTYA83688JI8JVbfL6oEdmuxKn5DK2CiCrDUkL56s3C8sCRl7wbwJqPPQ618aTW29mptyocEiNlNiXeDU1pqqOPrYMO4YYIPFl9wE5c4L2eu2Gb6F5Zhi321D3Oq7v1oNT4YXpFCvM1S3JbWEJhoskWLG95yZDEHg6fCZdQjLqjCeNX9CMwmxDxUF5Q2InmaD6riP1btT197c6dACmymtrellq69YZsNwzUSyXhdHd5gvgSOzSfduK4CvEgeVItLK1UvXctxuaRV2Oqesy0r39YPLQjOczyOib8D2jw4N9m4xePLTQ3IHjUTsns2HvNFKfGiNjllgqo1U02n4nD6AdIZ9CjF053AeRdCCKzvd23BpJoofzxLruHrtVF6PSyGItzMNHS1wGbFxmAM3Fgw63G1zZJhqfrgApggtO1785R4FsnMJ0RnG71ty4LH3dvNfSd
 required
input.stability number Voice stability parameter.
00.51
 optional
input.language_code string Language code of the audio.
afarhyasazbebnbsbgcacebnyhrcsdanlenetfilfifrglkadeelguhahehihuisidgaitjajvknkkkykolvlnltlbmkmsmlzhmrnenopsfaplptparorusrsdskslsoesswsvtatethtrukurvicy
 optional
Code samples
cURL
curl -X POST "https://business.api.cliprise.app/app/cliprise/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "elevenlabs-v3-dialogue",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "dialogue": [{"text":"Hello world","voice":"Adam"},{"text":"A response","voice":"Brian"}],
    "stability": 10000,
    "language_code": "your_value_here"
  }
}'
JavaScript
const response = await fetch("https://business.api.cliprise.app/app/cliprise/generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${YOUR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "elevenlabs-v3-dialogue",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "dialogue": [{"text":"Hello world","voice":"Adam"},{"text":"A response","voice":"Brian"}],
    "stability": 10000,
    "language_code": "your_value_here"
  }
}),
});
const [{ code, taskId }] = await response.json();
console.log("Task ID:", taskId);
Python
import requests

response = requests.post(
    "https://business.api.cliprise.app/app/cliprise/generate",
    headers={
        "Authorization": f"Bearer {YOUR_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
  "model": "elevenlabs-v3-dialogue",
  "callBackUrl": "https://your-app.com/webhook",
  "input": {
    "dialogue": [{"text":"Hello world","voice":"Adam"},{"text":"A response","voice":"Brian"}],
    "stability": 10000,
    "language_code": "your_value_here"
  }
}
)
task_id = response.json()[0]["taskId"]
print("Task ID:", task_id)
Response codes
200Accepted — returns a taskId to poll or await webhook.
400Bad request — missing or malformed body fields.
401Unauthorized — missing or invalid API key.
402Insufficient credits — top up your account.
429Rate limit exceeded — retry after cooldown.
200 success
[{ "code": 200, "taskId": "1b363b46636f61fb7e0e48ed7879" }]
Polling status
GEThttps://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID
AuthorizationBearer YOUR_API_KEY
processing success failure
success
[
  {
    "status": "success",
    "fileURL": "https://business.api.cliprise.app/app/cliprise/status?apiKey=API_KEY&taskId=TASK_ID&download=true"
  }
]
processing
[{ "status": "processing" }]
failure
{
  "status": "fail",
  "failMsg": "reason for failure"
}