GET /v1/models/{id}

Read a model

Permission

A key with chosen permissions needs media.read. A key made with every permission may always call it.

Parameters

• id (path)string · required

Response: Model

200 · A model this server can run.

• object"model"

• idstring

• typestring

  one of "image", "clip", "voiceover", "music"

• labelstring

• makerstring

• creditsnumber

  Credits for the request `credits_basis` names.

• credits_basisstring

• cost_rankinteger

  1 is the cheapest of its type.

• paid_bystring

  Who pays when a request names no payer: the vendor of your own key, "house" or "credits".

• defaultboolean

  Used when a request names no model.

• aspect_ratiosstring[]

• resolutionsstring[]

• durationobject | null

  Clip lengths in seconds; null for other types.

• settingobject | null

  The one model-specific image setting (`setting` on an image request).

• max_reference_imagesinteger

• max_reference_videosinteger

• max_reference_audiosinteger

• supports_first_frameboolean

• supports_last_frameboolean

• required_inputsobject

• voicesobject[]

  For a voice-over model, the voices it speaks with.

• languagesstring[]

• guideobject | null

  How to prompt it well. Only on `GET /v1/models/{id}`.

Example

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

curl "https://api.meetkuro.com/v1/models/<id>" \
  -H "Authorization: Bearer $KURO_API_KEY"

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

const kuro = new Kuro(); // reads KURO_API_KEY
await kuro.models.get("<id>");

Every operation