Skip to main content
POST
/
api
/
v1
/
jobs
/
createTask
curl -X POST https://kinovi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "midjourney-v7",
    "inputs": {
      "prompt": "A majestic snow leopard resting on a mountain cliff at golden hour, hyperrealistic photography",
      "aspectRatio": "16:9",
      "stylize": 500,
      "chaos": 20
    }
  }'

{
  "taskId": "task_clxxxxxxxxxxxxxx"
}

Documentation Index

Fetch the complete documentation index at: https://seedance2-pro.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Generate 4 high-quality images per run — photorealistic or anime style, V7 or V8.

​
How It Works

  1. You send a text prompt (and optionally a reference image URL)
  2. Midjourney generates 4 upscaled images based on your description
  3. You poll the task status or receive a webhook when the images are ready

​
Pricing

ModelCredits per RunPrice per RunOutput
midjourney-v712$0.064 images
midjourney-v7-niji12$0.064 images
midjourney-v812$0.064 images
1 credit = $0.005 (200 credits = $1). Each run generates 4 images.

​
Parameters

ParameterTypeRequiredDescription
modelstringYesmidjourney-v7, midjourney-v8 (photorealistic) or midjourney-v7-niji (anime style)
callBackUrlstringNoWebhook URL to receive task completion notification. See Webhooks for payload format.
inputsobjectYesGeneration parameters (see below)

​
inputs

ParameterTypeRequiredDescription
promptstringYesImage description.
aspectRatiostringNo1:1 (default), 16:9, 9:16, 3:4, 4:3, 21:9
sourceImageUrlstringNoReference image URL — the image will influence the generation result.
stylizeintegerNoControls how artistic the result is. Range: 0–1000. Lower = more literal, higher = more stylized. Maps to --s.
chaosintegerNoControls variation between the 4 images. Range: 0–100. Higher = more diverse. Maps to --chaos.
weirdintegerNoAdds unconventional aesthetics. Range: 0–3000. Maps to --weird.
qualitynumberNoRendering quality. Values: 0.25, 0.5, 1. Lower = faster but less detail. Maps to --q.
stylestringNo"raw" — reduces Midjourney’s default aesthetic, producing more photographic results.
nostringNoNegative prompt — things to exclude from the image. e.g. "text, watermark". Maps to --no.
seedintegerNoReproducibility seed. Range: 0–4294967295. Same seed + same prompt ≈ similar result. Maps to --seed.
Midjourney prompt tips:
  • Be concise: Midjourney works best with short, evocative prompts rather than long descriptions
  • Use style keywords: “cinematic lighting”, “hyperrealistic”, “studio photography”, “oil painting”
  • Niji is optimized for anime and illustration styles — use it for character art, manga, and stylized illustrations
  • V8 is the latest version with improved coherence and detail
  • Reference images are prepended to the prompt automatically — great for style transfer or subject consistency
Parameters like --ar, --v, --niji, --s, --chaos are handled automatically from your API fields. You do not need to add them in the prompt. If you include a flag in the prompt that conflicts with an API field, the prompt value takes priority.

​
Response

​
Create Task

Returns a taskId string. Use it to poll task status until completion.

​
Status Values

StatusDescription
waitingTask queued, waiting to start
generatingImages are being generated (typically 30–90 seconds)
successGeneration completed, 4 image URLs available in output
failGeneration failed, check error field for details

​
Error Codes

HTTP StatusDescriptionCommon Cause
200Success—
400Invalid parametersMissing prompt
401Authentication failedInvalid or missing API key
402Insufficient creditsLess than 12 credits remaining
404Task not foundInvalid taskId when polling status
429Concurrency limit exceededToo many tasks in progress
500Server errorInternal error, retry later
curl -X POST https://kinovi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "midjourney-v7",
    "inputs": {
      "prompt": "A majestic snow leopard resting on a mountain cliff at golden hour, hyperrealistic photography",
      "aspectRatio": "16:9",
      "stylize": 500,
      "chaos": 20
    }
  }'

{
  "taskId": "task_clxxxxxxxxxxxxxx"
}