ShareAI Platform Docs

Ƙirƙiri amsar rubutu

Yi amfani da ShareAI Responses API don samar da rubutu ba tare da yanayi ba, tarihin tattaunawa na musamman da abubuwan streaming na Responses.

Duba azaman Markdown
A wannan shafin
POST https://api.shareai.now/api/v1/responses

Samar da amsar rubutu daga tambaya ko tattaunawa.

URL na Asali
https://api.shareai.now
Tantancewa
Maɓallin API na Bearer ko takardar izinin shiga OAuth da aka amince da ita

Zaɓi wannan API lokacin da aikace-aikacenka ke amfani da tsarin saƙon rubutu na Responses. Samar da tattaunawa a kowane buƙata; ba a adana amsoshi don dawo da su daga baya ba.

Aika buƙata#

cURL

curl --fail-with-body --request POST \
  "https://api.shareai.now/api/v1/responses" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_CHAT_MODEL",
  "input": "Explain semantic search in two sentences.",
  "instructions": "Use plain language.",
  "store": false,
  "stream": false
}'

Filayen buƙata#

FilinDaraja
modelSamfurin tattaunawa da ake da shi wanda izinin ka ya yarda da shi.
inputRubutu mara komai, ko har zuwa saƙonni 256 na rubutu.
instructionsZaɓin umarnin tsarin da aka haɗa a farkon tattaunawar.
storefalse; ba a tallafa adana amsoshi ba.
streamfalse don JSON ko true don abubuwan Responses SSE.

Ci gaba da tattaunawa#

Aika saƙonni na baya a input tare da saƙon mai amfani na gaba. Matsayin da aka tallafa su ne user, assistant, system kuma developer. Umarnin mai haɓakawa suna amfani da matsayin tsarin a ciki. Abun cikin saƙon na iya zama rubutu ko input_text/output_text sassa.

JSON

{
  "model": "YOUR_CHAT_MODEL",
  "input": [
    {
      "role": "user",
      "content": "What is semantic search?"
    },
    {
      "role": "assistant",
      "content": "It finds results by meaning rather than exact words."
    },
    {
      "role": "user",
      "content": "Give one example."
    }
  ],
  "store": false
}

Karanta sakamakon#

Amsar JSON abu ne response abu. Karanta rubutun mataimaki daga output[].content[] shigarwa tare da nau'in output_text. Duba matsayin amsa: completed amsa ce da aka kammala; incomplete na iya nuna iyakar token. Jama'a usage a halin yanzu null ne; yi amfani da Console Usage don bincika amfani da aka sarrafa.

Rafi amsa#

Saita stream: true da fassara SSE. Abubuwan sun haɗa da response.created, response.output_text.delta da ƙarshen response.completed, response.incomplete ko response.failed. Haɗa deltas na rubutu a tsari kuma sarrafa matsayin ƙarshen a fili.

Rukunin da aka tallafa#

Wannan ƙarshen yana tallafawa samar da rubutu. Amsoshin da aka adana, previous_response_id, dawo/deleshon, kayan aiki, shigar hotuna, buƙatun bango da saitunan samarwa kamar temperature ba a goyan baya kuma an ƙi su. Don saitunan samarwa bisa saƙonni da Chat Completions ke goyan baya, yi amfani da Cikakkun Hira.

Yi amfani da alamar samun damar OAuth#

Maye gurbin maɓallin API a cikin kanun Authorization da ingantaccen OAuth access token. surcharge ana buƙatar iyaka da shirin amfani da aka amince da shi don inference da aka tallafa da asusu. Iyakar tantancewa kawai ba ta ba da izinin kashe kuɗi ba. Duba iyakoki da izini.

An sabunta karshe ranar 15 ga Satumba, 2026

Takardun Dandalin ShareAI
Duk takardu

Nemo ta taken ko abun ciki.

Tambayi game da wannan shafin

Zaɓi mataimaki don bincika wannan shafin. Hakanan za ku iya kwafa shafin ku liƙa shi cikin tattaunawarku.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI