Açıklamalar İngilizce

Bölümün arayüzü dilinize çevrildi, ancak işlem, şema ve hata açıklamaları yalnızca Rusça ve İngilizce mevcut — burada İngilizce sürüm gösteriliyor.

GET/orders/{order}/dub/quote

Dub quote

The price of dubbing a finished order BEFORE creating it — nothing is charged and the key's token pool is not spent. The parameters are the same as for POST /orders/{order}/dub, all optional: the price depends only on the source characters.

orders.read 429 limitler

source_chars — source characters (the paid length of its latest chunk versions);
tokens — tokens to be charged, of them tokens_from_quota — from the subscription quota, tokens_from_payg — beyond it (PAYG), lmc_cost_minor — the PAYG top-up in LMC minor units (the unit is currency_asset);
price_lumc_minor — the full dub price in LMC minor units, even when the quota pays;
allowed / reason — whether the order would go through right now (reason is the same code creation would return: insufficient_balance, token_quota_exceeded — the key's token quota is short, and so on);
defaults — the voice and model the dub uses without an explicit voice_id/model_id (the template snapshot of the source order or the chosen template_id; voice_id: null means the default voice is no longer available — pass your own);
source_template — the source order's template, templates — your templates of the same service to take a voice from (template_id).

The figures match the actual charge unless the quota or balance changes between the quote and the order. Limit — 60 quotes per minute per key.

Required key permission: orders.read.

Parametreler

Değerler doğrudan istek satırına yazılır ve URL kendiliğinden oluşur. Aşağıda her parametrenin türü, zorunlu olup olmadığı ve izin verilen değerleri var.

GEThttps://api.lumean.app/api/public/orders//dub/quote

orderstringyoldazorunlu
Order UUID — 36 characters shaped like 9f8b2c1a-4d3e-4f5a-8b9c-0d1e2f3a4b5c, not a number.

Take it from the id field: POST /orders returns it on creation and GET /orders lists it. Someone else’s order will not open with your key — you get a 404.
Değer doğrudan yukarıdaki istek satırına yerleşir.
target_languagestringsorgudaisteğe bağlı≤ 16 karakter
The dub language from the options' languages (GET /orders/dubbing/options). Optional: the price does not depend on the language; when passed, the quote checks in advance that it is allowed and differs from the source language.
voice_idstringsorgudaisteğe bağlı≤ 64 karakter
The dub voice. Optional: the price does not depend on the voice; without it defaults.voice_id holds the voice the dub will use.
model_idstringsorgudaisteğe bağlı≤ 64 karakter
The dub model from the options' models. Optional.
template_idstringsorgudaisteğe bağlı≤ 64 karakter
Your template of the same service as the source: defaults show its voice and model. Someone else's template or a template of another service gives 422.
namestringsorgudaisteğe bağlı≤ 120 karakter
Name of the future order; does not affect the price.

Olası yanıtlar

200

The quote.

Gövde örneği

{
  "success": true,
  "message": "string",
  "data": {
    "source_order_id": "string",
    "source_language": "string",
    "target_language": "string",
    "source_chars": 1,
    "tokens": 1,
    "tokens_from_quota": 1,
    "tokens_from_payg": 1,
    "lmc_cost_minor": 1,
    "lmc_cost_formatted": 1,
    "price_lumc_minor": 1,
    "price_lumc_formatted": 1,
    "currency_asset": {
      "code": "string",
      "precision": 1
    },
    "defaults": {
      "template_id": "string",
      "voice_id": null,
      "model_id": "string"
    },
    "source_template": {
      "id": "string",
      "name": "string"
    },
    "templates": [
      {
        "id": "string",
        "name": "string",
        "voice_id": "string",
        "model_id": "string"
      }
    ],
    "allowed": true,
    "reason": "string"
  }
}

Yanıt alanları

successzorunlu

Success flag. Branch on the HTTP status code instead: any 2xx response carries true here, while an error comes back in a different shape that need not contain this field at all.

boolean

messagezorunlu

A human-readable note in the account language. Fine to show to a user; do not parse it — the wording changes without notice and is not an error code.

string

datazorunlu

The response payload.

object

source_order_idzorunlu

The source order.

string

source_languagezorunlu

The source language (auto — unknown; a match with the dub language is then caught by the worker and refunded).

string

target_languagezorunlu

The dub language from the request, or null.

null olabilir

string

source_charszorunlu

Source characters — the paid length of its latest chunk versions. The price is based on them.

integer

tokenszorunlu

Tokens to be charged for the dub.

integer

tokens_from_quotazorunlu

How many tokens come from the subscription quota.

integer

tokens_from_paygzorunlu

How many tokens beyond the quota the balance pays (PAYG).

integer

lmc_cost_minorzorunlu

The PAYG top-up in LMC minor units (real = value / 10^currency_asset.precision). 0 — the quota covers it all.

integer

lmc_cost_formattedzorunlu

lmc_cost_minor in whole LMC.

number

price_lumc_minorzorunlu

The full dub price in LMC minor units — even when the quota pays. For showing the price in the user's currency.

integer

price_lumc_formattedzorunlu

price_lumc_minor in whole LMC.

number

currency_assetzorunlu

The unit of the *_minor amounts — LMC. Use precision to convert minor units into whole LMC.

object

codezorunlu

Asset code of the amounts.

DeğerlerLUMC

string

precisionzorunlu

LMC decimals: real = value / 10^precision.

integer

defaultszorunlu

What the dub uses without explicit voice_id/model_id.

object

template_idzorunlu

The template whose settings are used (the request template_id); null — the source order's template snapshot.

string

voice_idzorunlu

The default dub voice. null — the voice is no longer available (removed from the catalog, clone deleted): pass voice_id.

null olabilir

null

model_idzorunlu

The default dub model.

string

source_templatezorunlu

The source order's template (null — the order has no template).

null olabilir

object

idzorunlu

Template id.

string

namezorunlu

Template name.

string

templateszorunlu

Your templates of the same service as the source — candidates for template_id. Newest first, up to 100.

array<object>

dizi öğesi

idzorunlu

Template id — the value for template_id.

string

namezorunlu

Template name.

string

voice_idzorunlu

The template voice.

null olabilir

string

model_idzorunlu

The template model.

null olabilir

string

allowedzorunlu

true — an order with these parameters would go through right now (quota and balance suffice).

boolean

reasonzorunlu

Why it would not go through (allowed: false): the same code creation would return, e.g. insufficient_balance or token_quota_exceeded (the key's token quota is short).

Değerlertoken_quota_exceeded

string

401

The key is missing, unknown, disabled or expired.

Bu yanıtı çözümle

Gövde örneği

{
  "success": false,
  "message": "API key is missing. Provide it in the X-API-KEY header.",
  "data": null
}

Yanıt alanları

successzorunlu

Always false in error responses.

boolean

messagezorunlu

Error text in the key's language (set through the X-Locale header).

string

datazorunlu

Always null when the request is rejected before processing.

null olabilir

null

403

The key lacks the required permission, or the object belongs to another user.

Bu yanıtı çözümle

Gövde örneği

{
  "success": false,
  "message": "This API key does not have permission to perform this action."
}

Yanıt alanları

successzorunlu

Always false in error responses.

boolean

messagezorunlu

Error text in the key's language (set through the X-Locale header).

string

404

The order is not found or does not belong to the key owner.

Bu yanıtı çözümle

Gövde örneği

{
  "success": false,
  "message": "Resource not found."
}

Yanıt alanları

messagezorunlu

Error overview.

string

422

The same source refusals as dub creation: reason dub_source_unavailable, dub_source_too_long, dub_same_language, service_not_found; field validation errors.

Bu yanıtı çözümle

Gövde örneği

{
  "message": "string",
  "errors": {
    "key": [
      "string"
    ]
  }
}

Yanıt alanları

messagezorunlu

A summary of the validation errors in words, in the response language (X-Locale).

string

errorszorunlu

A per-field breakdown: the key names a request field, the value lists the complaints about it.

object

*isteğe bağlı

rastgele anahtarlar

array<string>

429

More than 60 quotes per minute per key.

Bu yanıtı çözümle

Gövde örneği

{
  "success": false,
  "message": "Too many attempts. Please wait a moment and try again.",
  "reason": "rate_limit_exceeded",
  "error_code": "rate_limit_exceeded",
  "retry_after": 30
}

Yanıt alanları

successzorunlu

Always false in error responses.

boolean

messagezorunlu

Error text in the key's language (set through the X-Locale header).

string

reasonzorunlu

Machine-readable failure reason — branch on this, not on the message text.

string

error_codezorunlu

The same machine-readable code as in reason — a second name for the field. The values always match; branch on either.

string

retry_afteristeğe bağlı

How many seconds to wait before retrying (the same value is in the Retry-After header).

null olabilir

integer

503

Dubbing of this kind is temporarily not accepted.

Gövde örneği

{
  "success": false,
  "message": "Service temporarily unavailable."
}

Yanıt alanları

successzorunlu

Always false in error responses.

boolean

messagezorunlu

Error text in the key's language (set through the X-Locale header).

string

Bunun ürettiği olaylar

İlerleme WebSocket üzerinden gelir: siparişi döngüde yoklamak gerekmez. Abonelik, siparişleri okumakla aynı izni gerektirir.

Düz anlatımla

Dubbing a finished order

Komşu işlemler

Daha fazla

Yapay zekâ için bu sayfa

.md sürümünü aç llm.md

API sürümü 1.0.0

Parametreler

Olası yanıtlar

Bunun ürettiği olaylar

İlgili içerik

Yapay zekâ için bu sayfa