Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Endpoints appoġġjati f'lotti

Lezzjoni 3 / 12 Aġġornat 2 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Seba’ endpoints, fluss ta’ ħidma wieħed
  2. Endpoints tat-test
  3. Endpoints tal-immaġni
  4. Endpoints tal-vidjo
  5. Tħallit ta’ endpoints f’lott
  6. Għażla tal-endpoint it-tajjeb
  7. Punti Ewlenin

Aġġornat fit-2 ta’ Novembru 2026, ibbażat fuq id-dokumentazzjoni ta’ xAI: l-iskont għall-lotti huwa 20% fuq mudelli tat-test eliġibbli (mhux 50%), l-eżempji jsegwu l-API REST u l-xai-sdk uffiċjali (client.batch.*; l-API tal-Lotti ta’ xAI ma tużax il-format ta’ OpenAI, allura l-SDK ta’ OpenAI ma japplikax), u l-API tar-Risposti tieħu preċedenza fuq it-Tlestija taċ-Chat, endpoint antik f’xAI. Sorsi: Batch API · REST reference · Batch pricing.

Seba’ endpoints, fluss ta’ ħidma wieħed

L-API tal-Lotti mhix limitata għall-ġenerazzjoni tat-test. Taċċetta seba’ endpoints li jkopru t-test, l-immaġni u l-vidjo, u tista’ tħallathom f’lott wieħed biex tibni pipelines multimodali sħaħ f’operazzjoni waħda.

Endpoints tat-test

/v1/responses — L-API tar-Risposti, dik li tirrakkomanda xAI. Tagħtik aċċess għal għodod fuq is-server (tiftix fil-web, tiftix fuq X, eżekuzzjoni tal-kodiċi, MCP), sejħiet ta’ funzjonijiet, u outputs strutturati, u tirċievi l-ewwel karatteristiċi ġodda.

/v1/chat/completions — L-endpoint oriġinali tat-tlestija, fil-format ta’ OpenAI. xAI iżommu bħala endpoint antik: għadu utli għal kodiċi eżistenti miktub għalih, imma pipeline ġdida taħdem aħjar jekk tibda bir-Risposti.

Fuq mudelli eliġibbli, l-iskont ta’ 20% għall-lotti japplika għaż-żewġ endpoints, fuq it-tipi kollha ta’ tokens.

Endpoints tal-immaġni

/v1/images/generations — Jiġġenera immaġni minn prompt. Il-parametri li se tuża huma aspect_ratio (pereżempju "16:9"), resolution ("1k", "1.5k", jew "2k"), n għan-numru ta’ immaġni, u response_format ("url" jew "b64_json").

/v1/images/edits — Jeditja immaġni eżistenti, speċifikata minn oġġett image li fih url (indirizz pubbliku jew data kodifikata b’base64) jew il-file_id ta’ fajl imtella’. Utli biex tmexxi trasformazzjonijiet f’serje fuq katalogu viżiv.

L-immaġni jiġu ffratturati bir-rata standard, mingħajr skont għall-lotti: hawnhekk il-valur tal-ipproċessar f’lotti huwa operattiv, mhux finanzjarju.

Endpoints tal-vidjo

/v1/videos/generations (jew /v1/videos) — Jiġġenera vidjos minn prompt, minn sekonda 1 sa 15-il sekonda (duration, 8 b’mod default), f’480p, 720p, jew 1080p.

/v1/videos/edits — Jeditja vidjo eżistenti, mgħoddi f’oġġett video (l-URL ta’ fajl .mp4 jew file_id).

/v1/videos/extensions — Jestendi vidjo b’segment ġdid ta’ bejn 2 u 10 sekondi.

Bħall-immaġni, l-ipprezzar tal-vidjo jibqa’ fir-rata standard fil-modalità ta’ lott. Ir-riżultati tal-immaġni u tal-vidjo jerġgħu lura bħala URLs iffirmati li jiskadu wara siegħa.

Tħallit ta’ endpoints f’lott

F’fajl JSONL, kull linja tsemmi l-endpoint tagħha fil-qasam url:

{"custom_id": "text-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "Summarize this article: ..."}]}}
{"custom_id": "img-1", "method": "POST", "url": "/v1/images/generations", "body": {"model": "grok-imagine-image-2.0", "prompt": "Minimalist logo for a neighborhood bookstore"}}

Hekk tista’ tiġġenera d-deskrizzjonijiet tal-prodott tiegħek u l-viżwali tagħhom fl-istess lott.

Għażla tal-endpoint it-tajjeb

  • Risposti: l-għażla default, essenzjali malli jkollok bżonn għodod fuq is-server, outputs strutturati, jew l-aħħar karatteristiċi
  • Tlestija taċ-Chat: kontinwità għal kodiċi diġà miktub fil-format tat-Tlestija taċ-Chat, u xejn aktar
  • Immaġni u vidjo: għall-produzzjoni ta’ viżwali f’serje, filwaqt li tiftakar li ma jirċievu l-ebda skont

Punti Ewlenin

  • Seba’ endpoints huma aċċettati: żewġ għat-test, żewġ għall-immaġni, tlieta għall-vidjo
  • Risposti huwa l-endpoint irrakkomandat; Tlestija taċ-Chat huwa endpoint antik f’xAI
  • Biss it-tokens fuq mudelli tat-test eliġibbli jiksbu l-iskont ta’ 20%
  • Il-qasam url ta’ kull linja JSONL jiddetermina l-endpoint fil-mira, u l-endpoints jistgħu jitħalltu fi ħdan lott wieħed
  • Ir-riżultati tal-immaġni u tal-vidjo huma URLs iffirmati validi għal siegħa