# Cercetare (/ro/docs/api/gateway/research)

Cercetare aprofundată asincronă: un raport cu citări, din mai multe căutări și citiri de pagini.

`POST /v1/research` pornește un job care planifică mai multe căutări, citește cele mai bune pagini și scrie un raport în care fiecare afirmație își citează sursa ca `[S1]`..`[Sn]` (sau, cu `output_schema`, un `answer` JSON). Cererea așteaptă cel mult `wait_s` secunde (implicit 0) și răspunde 200 cu jobul terminat sau 202 cât timp este `queued` / `running`; interoghezi `GET /v1/research/{id}` până când `status` devine `done` sau `failed`. Același `Idempotency-Key` trimis din nou întoarce jobul existent; aceeași cheie cu alt corp dă `409 idempotency_key_reused`. Admiterea este aceeași ca la [unelte](./tools.mdx) — regulile tale îl văd ca `web_search`. Preț: 0,20 $ per job plus tokenii lui de model; joburile din alocarea gratuită lunară nu plătesc taxa de job. Cel mult 3 joburi pe utilizator rulează simultan și 30 pornesc într-o zi UTC (`429`); `output_schema` poate avea cel mult 16 kB. Un job terminat are `ai_generated: true` și `cost.model_micro_usd`.

SDK-urile se ocupă de interogare: `codai.research.run({ question })` (TypeScript) și `codai.research.run("…")` (Python) pornesc jobul și îl așteaptă. Același motor este unealta `deep_research` din VS Code, desktop, telefon, headless și MCP-ul găzduit. Detalii: [ghidul de unelte](../../agents/tools.mdx#cercetare-aprofundată--v1research).

<OpenAPIPage document="./openapi/ro/gateway.yaml" operations={[{path: '/v1/research',method: 'post'},{path: '/v1/research/{id}',method: 'get'}]} />