POST /v1/quotes

Price a request

Permission

A key with chosen permissions needs generation.write. A key made with every permission may always call it.

Body: type: "image"

• type"image" · required

• promptstring · optional

  up to 2000 characters

• modelstring · optional

  Defaults to the server's default image model.

  up to 80 characters

• aspect_ratiostring · optional

  Such as "9:16", "1:1" or "16:9". Defaults to 9:16, snapped to what the model offers.

  up to 12 characters

• settingstring · optional

  The model's one extra setting (`setting` on `GET /v1/models/{id}`), such as its quality.

  up to 40 characters

• referencesMediaReference[] · optional

  Pictures the model can see. The model's `max_reference_images` applies.

  up to 16 items

• subjectsstring[] · optional

  Names or ids of your Subjects. Kuro brings each one's face and description, so do not also attach pictures of them.

  up to 4 items

• runs_onstring · optional

  Who pays: "credits", or the vendor of one of your own keys ("replicate", "fal", …). Leave out to follow the payer order set in Settings → Agents.

  up to 40 characters

Body: type: "clip"

• type"clip" · required

• promptstring · optional

  up to 4000 characters

• modelstring · optional

  Defaults to the server's default clip model.

  up to 80 characters

• duration_secondsinteger · optional

  One of the model's `duration.values`; -1 lets a model that supports it choose.

  min -1 · max 60

• resolutionstring · optional

  up to 12 characters

• aspect_ratiostring · optional

  Defaults to 9:16. Leave out with a `first_frame`: the clip takes the frame's shape.

  up to 12 characters

• generate_audioboolean · optional

• first_frameMediaReference · optional

  A picture, clip or sound you already have in Kuro.

• last_frameMediaReference · optional

  A picture, clip or sound you already have in Kuro.

• reference_imagesMediaReference[] · optional

  up to 9 items

• reference_videosMediaReference[] · optional

  A take to copy motion from, or to re-sync a mouth in.

  up to 3 items

• reference_audiosMediaReference[] · optional

  up to 3 items

• subjectsstring[] · optional

  Names or ids of your Subjects. Kuro brings each one's face and description, so do not also attach pictures of them.

  up to 4 items

• runs_onstring · optional

  Who pays: "credits", or the vendor of one of your own keys ("replicate", "fal", …). Leave out to follow the payer order set in Settings → Agents.

  up to 40 characters

Body: type: "voiceover"

• type"voiceover" · required

• textstring · required

  The words to speak.

  up to 4000 characters

• subjectstring · optional

  A Subject whose bound voice reads it. Then leave out model, voice, style_prompt and language_code.

  up to 120 characters

• modelstring · optional

  up to 80 characters

• voicestring · optional

  A voice id from the model's `voices`.

  up to 120 characters

• style_promptstring · optional

  How to say it, on models that take one.

  up to 4000 characters

• language_codestring · optional

  up to 35 characters

• speednumber · optional

  min 0.1 · max 5

• emotionstring · optional

  up to 40 characters

• runs_onstring · optional

  Who pays: "credits", or the vendor of one of your own keys ("replicate", "fal", …). Leave out to follow the payer order set in Settings → Agents.

  up to 40 characters

Body: type: "music"

• type"music" · required

• promptstring · required

  The brief: genre, mood, instruments, tempo.

  up to 4000 characters

• modelstring · optional

  up to 80 characters

• lyricsstring · optional

  up to 3500 characters

• instrumentalboolean · optional

  Defaults to true when there are no lyrics.

• runs_onstring · optional

  Who pays: "credits", or the vendor of one of your own keys ("replicate", "fal", …). Leave out to follow the payer order set in Settings → Agents.

  up to 40 characters

Body: type: "recipe"

• promptstring · optional

  The idea, in the words the recipe's `prompt` asks for.

  up to 4000 characters

• inputsobject · optional

  By key. On an `arm` or `reprompt` recipe, each of its `inputs` takes a list of media (`{ "type": "upload", "upload_id" }`, `{ "type": "generation", "generation_id" }`) or one Subject (`{ "type": "subject", "subject_id" }`). On a `run` recipe, each of its `run_inputs` takes the value its type asks for.

• choicesobject · optional

  One option `value` per choice, by key; a list where `max_picks` is above one.

• modelstring · optional

  Another model of the recipe's medium. Not for `run` recipes.

  up to 80 characters

• runs_onstring · optional

  Who pays: "credits", or the vendor of one of your own keys ("replicate", "fal", …). Leave out to follow the payer order set in Settings → Agents.

  up to 40 characters

• type"recipe" · required

• recipe_idstring · required

  uuid

Response: Quote

200 · A price, before anything is spent.

• object"quote"

• creditsnumber

  What it would cost, in credits.

• paid_bystring | null

  Who would pay: "credits", "house", "server", or the vendor of your own key.

• estimated_cost_usdnumber | null

  What your own provider account would be charged, when your key pays.

• available_creditsnumber

• affordableboolean

  Whether it can run now.

• aspect_ratiostring | null

• blockedobject | null

  Why the payer named in `runs_on` cannot take it.

Example

The required fields only, each a placeholder. Replace them before sending.

curl -X POST "https://api.meetkuro.com/v1/quotes" \
  -H "Authorization: Bearer $KURO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"image","prompt":"<prompt>"}'

import { Kuro } from "@meetkuro/sdk";

const kuro = new Kuro(); // reads KURO_API_KEY
await kuro.quotes.create({ type: "image", prompt: "A lighthouse at dawn" });

Every operation