İçeriğe geç
Lumean API

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}/items/{item}/text

Get Order Item Text

Returns the text the chunk was generated from.

orders.read

The main use is fixing a policy_flagged chunk: the provider rejected the content, and retrying the same text will be rejected again. The sequence is: fetch the text here → rephrase the problematic part → send POST /orders/{order}/items/{item}/retry with a text field.

The API does not report why the content was rejected — there is no such field. Edit the text at your own judgement.

If the text was deleted with the order's storage retention, you get 422 with reason: input_expired. It cannot be restored: create the order anew (a retry with a new text still works).

Required key permission: orders.read.

Bu sayfada(4)

Parametreler

Giriş alanları doğrudan istek satırında yer alır: bir değer girin, hazır URL'yi alın. Aşağıda her parametrenin türü, zorunlu olup olmadığı ve izin verilen değerleri var.

GEThttps://api.lumean.app/api/public/orders//items//text
  • stringyoldazorunlu

    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.

  • stringyoldazorunlu

    Order chunk UUID — 36 characters; neither a number nor a position.

    Take it from an item’s id field: GET /orders/{order}/items returns the list, and the same set sits in items[] of the detailed order response. The chunk’s position is the neighbouring chunk_index field, which does not go into the path.

    Değer doğrudan yukarıdaki istek satırına yerleşir.

Olası yanıtlar

200

Success. The payload is in data.

Gövde örneği
{
  "success": true,
  "message": "Success",
  "data": {
    "text": "Welcome to our platform! This narration greets every new listener.",
    "length": 66,
    "original_text_length": 240
  }
}
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
textzorunlu

The fragment’s text verbatim — all tags included. This is what you send to regenerate after editing.

string
lengthzorunlu

Full text length in characters, tags included.

integer
original_text_lengthzorunlu

Alias of free_length, kept for backward compatibility.

integer
free_lengthzorunlu

The largest already-paid length of the fragment: retries within it are free, beyond it a surcharge applies.

integer
billable_lengthzorunlu

How many characters of the current text are billed. Only our own pause tags {{pause=2s}} are free; [whisper] and <break/> reach the provider and are charged.

integer
max_raw_lengthzorunlu

Technical cap on the fragment length — how much the system will hand the worker in one piece, measured in capacity_unit. Exceeding it yields 422.

integer
max_billable_lengthzorunlu

Cap on billable characters. Going over makes the regeneration more expensive or unavailable.

integer
surcharge_applieszorunlu

true means excess length carries a surcharge. Check it before calling regenerate so the charge is no surprise.

string
capacity_unitzorunlu

Unit of max_raw_length and raw_length: chars — characters, utf8_bytes — UTF-8 bytes (Fish Audio caps a request in bytes: a Cyrillic letter is 2 bytes, a Latin one is 1).

string
raw_lengthzorunlu

Length of the current text in capacity_unit — the value compared against max_raw_length.

integer
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ı
messagezorunlu

Error overview.

string
404

Not found, or not reachable with this key.

Bu yanıtı çözümle
Gövde örneği
{
  "success": false,
  "message": "Resource not found."
}
Yanıt alanları
messagezorunlu

Error overview.

string
422

Validation error. Offending fields are listed in errors.

Bu yanıtı çözümle
Gövde örneği
{
  "success": true,
  "message": "string",
  "reason": "string",
  "error_code": "string"
}
Yanıt alanları
successzorunlu

Always false in error responses.

boolean
messagezorunlu

The reason for the rejection in words, in the account language. Meant for display; do not branch on it, the wording changes.

string
reasonzorunlu

Machine-readable reason of a business refusal (for example, input_expired, insufficient_balance). Branch on it, 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.

string

Bunun ürettiği olaylar

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

İlgili içerik

Bu sayfayı yapay zekâya verin

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

spesifikasyon 0.0.1