Sonar Reasoning is het met redenering versterkte zoekprofiel van Perplexity voor vragen die interpretatie van bewijsmateriaal vereisen, in plaats van een kort, losstaand feit. De maker onderscheidt het van Sonar Reasoning Pro en de andere Sonar-zoekprofielen. Het bruikbare resultaat is een tekstantwoord dat op bewijsmateriaal uit webbronnen steunt, waarbij redenering helpt om materiaal te vergelijken en een conclusie over de gestelde vraag te ontwikkelen.
Benoem het onderwerp, de vast te stellen feiten en de criteria die het antwoord moet gebruiken. Een productvergelijking kan vragen naar de gedocumenteerde mogelijkheden en beperkingen die relevant zijn voor één workflow. Een vraag over een gebeurtenis die zich ontwikkelt, moet de gebeurtenis, tijdsperiode en te verifiëren uitkomst benoemen. Geef het gewenste eindproduct aan: een korte uitleg, een tabel met bewijsmateriaal of een vergelijking die rond de te nemen beslissing is opgebouwd.
Houd aangeleverde achtergrondinformatie gescheiden van wat de zoekopdracht moet vaststellen. Vraag om een ontbrekende belangrijke voorwaarde open te laten in plaats van die met een aannemelijke aanname in te vullen. Een afgebakende vraag maakt het eenvoudiger te beoordelen of het opgehaalde materiaal die werkelijk beantwoordt, vooral wanneer meerdere bronnen verwante maar verschillende gevallen bespreken.
De fabrikant beschrijft Sonar Reasoning als onderdeel van zijn zoekfamilie met versterkte redenering. Gebruik het teruggegeven materiaal om alternatieven te vergelijken, een schijnbare tegenspraak op te lossen of uit te leggen waarom een conclusie uit het bewijsmateriaal volgt. Een door bronnen ondersteund redeneringsantwoord moet onderscheid maken tussen wat een pagina vermeldt en de gevolgtrekking die ontstaat door meerdere pagina's te combineren.
Vraag bij een vraag over vereisten welke bron het kenmerk documenteert en of de voorwaarden overeenkomen met het beoogde gebruik. Behoud bij een tijdsgevoelig feit de timing van de bron en de context waarin die de gebeurtenis beschrijft. Een pagina die relevant lijkt, kan over een eerdere versie of een ander geval gaan. Het verband met de vraag telt daarom zwaarder dan alleen de aanwezigheid van een bronverwijzing.
De Sonar-antwoordworkflow van de producent koppelt een antwoord aan bronverwijzingen. Bewaar die verwijzingen bij de passages die ze ondersteunen, zodat een andere lezer het bewijsmateriaal kan onderzoeken. Een vergelijkingstabel kan het item, de vermelde mogelijkheid, de ondersteunende bron en de onopgeloste voorwaarde bij elkaar houden. Controleer of het aangehaalde materiaal de exacte waarde vaststelt of slechts een verwante bewering ondersteunt.
Een bruikbare overdracht kan de oorspronkelijke vraag, het samengestelde antwoord en de ondersteunende bronnen bevatten. Behoud belangrijke namen, getallen en verschillen tussen bronnen wanneer je het resultaat in een afgewerkt document opneemt. Als het antwoord een doorslaggevend criterium onopgelost laat, richt een vervolgvraag dan specifiek op dat criterium in plaats van het niet-onderbouwde veld als voltooid te beschouwen.
Sonar Reasoning en Reasoning Pro zijn afzonderlijk benoemde profielen van de producent. De latere Agent API heeft eigen modellen, toolprimitieven en een eigen aanvraagformaat. Die nieuwere functies mogen daarom niet als de oorspronkelijke specificatie van dit profiel worden beschouwd. Bouw voort op het werkelijke antwoord en het bijbehorende bewijsmateriaal en behoud het geselecteerde profiel en de taakvoorwaarden wanneer je resultaten vergelijkt. De praktische waarde is een beoordeelbaar redeneringsresultaat dat voor een concrete onderzoeksvraag aan bronnen gekoppeld is.
", "aboutText": "Sonar Reasoning is het met redenering versterkte zoekprofiel van Perplexity voor vragen die interpretatie van bewijsmateriaal vereisen, in plaats van een kort, losstaand feit. De maker onderscheidt het van Sonar Reasoning Pro en de andere Sonar-zoekprofielen. Het bruikbare resultaat is een tekstantwoord dat op bewijsmateriaal uit webbronnen steunt, waarbij redenering helpt om materiaal te vergelijken en een conclusie over de gestelde vraag te ontwikkelen.\n\n### Bepaal de onderzoeksvraag en het resultaat\n\nBenoem het onderwerp, de vast te stellen feiten en de criteria die het antwoord moet gebruiken. Een productvergelijking kan vragen naar de gedocumenteerde mogelijkheden en beperkingen die relevant zijn voor één workflow. Een vraag over een gebeurtenis die zich ontwikkelt, moet de gebeurtenis, tijdsperiode en te verifiëren uitkomst benoemen. Geef het gewenste eindproduct aan: een korte uitleg, een tabel met bewijsmateriaal of een vergelijking die rond de te nemen beslissing is opgebouwd.\n\nHoud aangeleverde achtergrondinformatie gescheiden van wat de zoekopdracht moet vaststellen. Vraag om een ontbrekende belangrijke voorwaarde open te laten in plaats van die met een aannemelijke aanname in te vullen. Een afgebakende vraag maakt het eenvoudiger te beoordelen of het opgehaalde materiaal die werkelijk beantwoordt, vooral wanneer meerdere bronnen verwante maar verschillende gevallen bespreken.\n\n### Combineer redenering met bronbewijsmateriaal\n\nDe fabrikant beschrijft Sonar Reasoning als onderdeel van zijn zoekfamilie met versterkte redenering. Gebruik het teruggegeven materiaal om alternatieven te vergelijken, een schijnbare tegenspraak op te lossen of uit te leggen waarom een conclusie uit het bewijsmateriaal volgt. Een door bronnen ondersteund redeneringsantwoord moet onderscheid maken tussen wat een pagina vermeldt en de gevolgtrekking die ontstaat door meerdere pagina's te combineren.\n\nVraag bij een vraag over vereisten welke bron het kenmerk documenteert en of de voorwaarden overeenkomen met het beoogde gebruik. Behoud bij een tijdsgevoelig feit de timing van de bron en de context waarin die de gebeurtenis beschrijft. Een pagina die relevant lijkt, kan over een eerdere versie of een ander geval gaan. Het verband met de vraag telt daarom zwaarder dan alleen de aanwezigheid van een bronverwijzing.\n\n### Bewaar bronverwijzingen bij het voltooide antwoord\n\nDe Sonar-antwoordworkflow van de producent koppelt een antwoord aan bronverwijzingen. Bewaar die verwijzingen bij de passages die ze ondersteunen, zodat een andere lezer het bewijsmateriaal kan onderzoeken. Een vergelijkingstabel kan het item, de vermelde mogelijkheid, de ondersteunende bron en de onopgeloste voorwaarde bij elkaar houden. Controleer of het aangehaalde materiaal de exacte waarde vaststelt of slechts een verwante bewering ondersteunt.\n\nEen bruikbare overdracht kan de oorspronkelijke vraag, het samengestelde antwoord en de ondersteunende bronnen bevatten. Behoud belangrijke namen, getallen en verschillen tussen bronnen wanneer je het resultaat in een afgewerkt document opneemt. Als het antwoord een doorslaggevend criterium onopgelost laat, richt een vervolgvraag dan specifiek op dat criterium in plaats van het niet-onderbouwde veld als voltooid te beschouwen.\n\n### Houd het benoemde redeneerprofiel afzonderlijk\n\nSonar Reasoning en Reasoning Pro zijn afzonderlijk benoemde profielen van de producent. De latere Agent API heeft eigen modellen, toolprimitieven en een eigen aanvraagformaat. Die nieuwere functies mogen daarom niet als de oorspronkelijke specificatie van dit profiel worden beschouwd. Bouw voort op het werkelijke antwoord en het bijbehorende bewijsmateriaal en behoud het geselecteerde profiel en de taakvoorwaarden wanneer je resultaten vergelijkt. De praktische waarde is een beoordeelbaar redeneringsresultaat dat voor een concrete onderzoeksvraag aan bronnen gekoppeld is.", "editorialOverlay": { "copy_fields": { "practical_html": "Technisch voorbeeld in het Engels
Research a protocol distinction\n\nFind the IETF HTTP Semantics specification and explain how HEAD differs from GET for response content and metadata. Prepare a small evidence table with official source references, then give one practical use of HEAD. Distinguish what the specification requires from your example and leave any server-specific behavior unresolved.A source-backed comparison table and a clearly labelled application example with citations.Inspect the cited specification sections and check that each claim concerns the actual GET/HEAD distinction.sonar-reasoningSonar Reasoning combineert de zoekfunctie van Perplexity met redenering voor brongebaseerde vragen en vergelijkingen. Het levert een tekstantwoord dat op webbewijsmateriaal steunt, waarbij de oorspronkelijke vraag en bronverwijzingen voor controle behouden blijven.
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Sonar Reasoning is het met redenering versterkte zoekprofiel van Perplexity voor vragen die interpretatie van bewijsmateriaal vereisen, in plaats van een kort, losstaand feit. De maker onderscheidt het van Sonar Reasoning Pro en de andere Sonar-zoekprofielen. Het bruikbare resultaat is een tekstantwoord dat op bewijsmateriaal uit webbronnen steunt, waarbij redenering helpt om materiaal te vergelijken en een conclusie over de gestelde vraag te ontwikkelen.
Benoem het onderwerp, de vast te stellen feiten en de criteria die het antwoord moet gebruiken. Een productvergelijking kan vragen naar de gedocumenteerde mogelijkheden en beperkingen die relevant zijn voor één workflow. Een vraag over een gebeurtenis die zich ontwikkelt, moet de gebeurtenis, tijdsperiode en te verifiëren uitkomst benoemen. Geef het gewenste eindproduct aan: een korte uitleg, een tabel met bewijsmateriaal of een vergelijking die rond de te nemen beslissing is opgebouwd.
Houd aangeleverde achtergrondinformatie gescheiden van wat de zoekopdracht moet vaststellen. Vraag om een ontbrekende belangrijke voorwaarde open te laten in plaats van die met een aannemelijke aanname in te vullen. Een afgebakende vraag maakt het eenvoudiger te beoordelen of het opgehaalde materiaal die werkelijk beantwoordt, vooral wanneer meerdere bronnen verwante maar verschillende gevallen bespreken.
De fabrikant beschrijft Sonar Reasoning als onderdeel van zijn zoekfamilie met versterkte redenering. Gebruik het teruggegeven materiaal om alternatieven te vergelijken, een schijnbare tegenspraak op te lossen of uit te leggen waarom een conclusie uit het bewijsmateriaal volgt. Een door bronnen ondersteund redeneringsantwoord moet onderscheid maken tussen wat een pagina vermeldt en de gevolgtrekking die ontstaat door meerdere pagina's te combineren.
Vraag bij een vraag over vereisten welke bron het kenmerk documenteert en of de voorwaarden overeenkomen met het beoogde gebruik. Behoud bij een tijdsgevoelig feit de timing van de bron en de context waarin die de gebeurtenis beschrijft. Een pagina die relevant lijkt, kan over een eerdere versie of een ander geval gaan. Het verband met de vraag telt daarom zwaarder dan alleen de aanwezigheid van een bronverwijzing.
De Sonar-antwoordworkflow van de producent koppelt een antwoord aan bronverwijzingen. Bewaar die verwijzingen bij de passages die ze ondersteunen, zodat een andere lezer het bewijsmateriaal kan onderzoeken. Een vergelijkingstabel kan het item, de vermelde mogelijkheid, de ondersteunende bron en de onopgeloste voorwaarde bij elkaar houden. Controleer of het aangehaalde materiaal de exacte waarde vaststelt of slechts een verwante bewering ondersteunt.
Een bruikbare overdracht kan de oorspronkelijke vraag, het samengestelde antwoord en de ondersteunende bronnen bevatten. Behoud belangrijke namen, getallen en verschillen tussen bronnen wanneer je het resultaat in een afgewerkt document opneemt. Als het antwoord een doorslaggevend criterium onopgelost laat, richt een vervolgvraag dan specifiek op dat criterium in plaats van het niet-onderbouwde veld als voltooid te beschouwen.
Sonar Reasoning en Reasoning Pro zijn afzonderlijk benoemde profielen van de producent. De latere Agent API heeft eigen modellen, toolprimitieven en een eigen aanvraagformaat. Die nieuwere functies mogen daarom niet als de oorspronkelijke specificatie van dit profiel worden beschouwd. Bouw voort op het werkelijke antwoord en het bijbehorende bewijsmateriaal en behoud het geselecteerde profiel en de taakvoorwaarden wanneer je resultaten vergelijkt. De praktische waarde is een beoordeelbaar redeneringsresultaat dat voor een concrete onderzoeksvraag aan bronnen gekoppeld is.
POST /v1/chat/completionstexttext| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten sonar-reasoning | Standaard— |
Veldmessages | Typemessage[] | VereisteVereist | Waarden en limieten Minimumaantal items: 1 | Standaard— |
Veldmessages[].role | Typestring | VereisteVereist | Waarden en limieten Voorbeelden: system, user, assistant, tool, function Voorwaarden: Deze rollen worden expliciet weergegeven door compatibiliteitstypen in de broncode; de exacte rollenverzameling van het model blijft modelspecifiek. Afhankelijk van het model | Standaard— |
Veldmessages[].content | Typestring|content_part[]|null | VereisteOptioneel | Waarden en limieten | Standaard— |
Veldmessages[].tool_calls | Typetool_call[] | VereisteOptioneel | Waarden en limieten | Standaard— |
Veldmessages[].tool_call_id | Typestring | VereisteOptioneel | Waarden en limieten Geldt wanneer: role=tool; gebruik het werkelijk teruggegeven ID | Standaard— |
Veldmessages[].name | Typestring | VereisteOptioneel | Waarden en limieten | Standaard— |
Veldmessages[].reasoning_content | Typestring | VereisteOptioneel | Waarden en limieten Geldt wanneer: Stuur de werkelijk teruggegeven redeneringen terug wanneer dit model ze gebruikt | Standaard— |
Veldmessages[].reasoning_details | Typeobject|array | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldmax_tokens | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 1 Afhankelijk van het model | Standaard— |
Veldmax_completion_tokens | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 1 Afhankelijk van het model | Standaard— |
Veldstream | Typeboolean | VereisteOptioneel | Waarden en limieten | Standaardfalse |
Veldstream_options.include_usage | Typeboolean | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldtemperature | Typenumber | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldtop_p | Typenumber | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldstop | Typestring|string[] | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldtools | Typefunction_tool[] | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldtools[].type | Typestring | VereisteOptioneel | Waarden en limieten function Afhankelijk van het model | Standaard— |
Veldtools[].function.name | Typestring | VereisteVereist | Waarden en limieten Geldt wanneer: functietool opgegeven | Standaard— |
Veldtools[].function.description | Typestring | VereisteOptioneel | Waarden en limieten | Standaard— |
Veldtools[].function.parameters | TypeJSON_schema | VereisteOptioneel | Waarden en limieten | Standaard— |
Veldtool_choice | Typestring|object | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldparallel_tool_calls | Typeboolean | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldresponse_format | Typeobject | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldreasoning_effort | Typestring | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldreasoning | Typeobject | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldservice_tier | Typestring | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldinstructions | Typestring | VereisteOptioneel | Waarden en limieten Compatibiliteitsveld | Standaard— |
Veldfunctions | Typefunction[] | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldfunction_call | Typestring|object | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldprompt_cache_options | Typeobject | VereisteOptioneel | Waarden en limieten Afhankelijk van het model | Standaard— |
Veldmodalities | Typestring[] | VereisteOptioneel | Waarden en limieten text | Standaard— |
Veldprovider | Typeobject | VereisteOptioneel | Waarden en limieten Voorwaarden: provider.options wordt op deze Ultra-tekstroute geweigerd | Standaard— |
Veldcache_control.ttl | Typestring | VereisteOptioneel | Waarden en limieten Voorwaarden: 1h wordt op de daadwerkelijke locaties voor promptcaching geweigerd | Standaard— |
Tekst · UTF8-tekst
messages[].content
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, messages |
Parametermaterial_types | Contracttext |
Parametermessages | Contractberichtenarray met de structuur role/content |
Parameterfile_material | Contractwerkelijk UTF-8-document ingevoegd als letterlijke tekst; er wordt geen bestands-ID afgeleid |
Parameteroptional_controls | Contractstream, temperature, top_p, stop, max_tokens, max_completion_tokens, reasoning, response_format, tools, tool_choice |
Parametercontrol_scope | Contractmodelspecifiek; functietools van de gebruiker verschillen van gehoste tools |
Parameteroutput_modalities | Contracttext |
Parameterhosted_operations | Contractfalse |
Parametermultimodal_input_binding | Contractnull |
Levenscyclus: synchronous_or_streamed
Stuur het exacte model-ID mee met messages.
Contextlengte is geen uitvoerlimiet.
Een tekstbestand kan letterlijke tekst aanleveren; beeld-, audio- en bestandsobjectinvoer vereisen een exacte koppeling.
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Tariefstaffel | Gefactureerde hoeveelheid | Kosten |
|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Gefactureerde hoeveelheid— | Kosten Invoer · Invoertokens $0.0044 / 1K tokens Uitvoer · Uitvoertokens $0.0176 / 1K tokens Invoer · Cache lezen $0 / 1K tokens Invoer · Cache schrijven $0 / 1K tokens Invoer · Cache schrijven, 1 uur — / 1K tokens |
| ConfiguratiePer aanvraag | Tariefstaffel— | Gefactureerde hoeveelheidéén verzoek | Kosten Invoer $0.01 per verzoek |
Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "sonar-reasoning", "messages": [{"role": "user", "content": "Explain the difference between an observation and a hypothesis in three sentences."}]}')\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/chat/completions \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nfor x in r.get("choices",[]):\n if x.get("message",{}).get("content"): print(x["message"]["content"])\nPY_RESULT\nfrom openai import OpenAI\nimport os\n\nif not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.chat.completions.create(model='sonar-reasoning',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}])\nimport base64, json\nfrom pathlib import Path\n\ndef save_result(data, stem="result"):\n # Keep every field, including usage, IDs, reasoning and tool requests.\n Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")\n print(json.dumps(data, ensure_ascii=False, indent=2))\n def save_blob(encoded, suffix, label):\n raw = base64.b64decode(encoded, altchars=b"-_", validate=True)\n ext = "png" if raw.startswith(b"\\x89PNG\\r\\n\\x1a\\n") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix\n file = Path(stem + "-" + label + "." + ext)\n file.write_bytes(raw)\n print("Saved", file)\n for index, block in enumerate(data.get("content") or []):\n print("Content", index, json.dumps(block, ensure_ascii=False))\n for choice in data.get("choices") or []:\n print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False))\n for index, item in enumerate(data.get("output") or []):\n print("Output", index, json.dumps(item, ensure_ascii=False))\n if item.get("type") == "image_generation_call" and item.get("result"):\n save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index))\n for ci, candidate in enumerate(data.get("candidates") or []):\n for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []):\n print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False))\n blob = part.get("inlineData") or part.get("inline_data")\n if blob and blob.get("data"):\n mime = blob.get("mimeType") or blob.get("mime_type")\n suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin")\n save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi))\n\nsave_result(result.to_dict(mode="json"))\nfrom openai import OpenAI\nimport os\nfrom pathlib import Path\n\nif not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nimport base64, json\nfrom pathlib import Path\n\ndef save_result(data, stem="result"):\n # Keep every field, including usage, IDs, reasoning and tool requests.\n Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")\n print(json.dumps(data, ensure_ascii=False, indent=2))\n def save_blob(encoded, suffix, label):\n raw = base64.b64decode(encoded, altchars=b"-_", validate=True)\n ext = "png" if raw.startswith(b"\\x89PNG\\r\\n\\x1a\\n") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix\n file = Path(stem + "-" + label + "." + ext)\n file.write_bytes(raw)\n print("Saved", file)\n for index, block in enumerate(data.get("content") or []):\n print("Content", index, json.dumps(block, ensure_ascii=False))\n for choice in data.get("choices") or []:\n print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False))\n for index, item in enumerate(data.get("output") or []):\n print("Output", index, json.dumps(item, ensure_ascii=False))\n if item.get("type") == "image_generation_call" and item.get("result"):\n save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index))\n for ci, candidate in enumerate(data.get("candidates") or []):\n for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []):\n print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False))\n blob = part.get("inlineData") or part.get("inline_data")\n if blob and blob.get("data"):\n mime = blob.get("mimeType") or blob.get("mime_type")\n suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin")\n save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi))\n\nwith client.chat.completions.stream(model='sonar-reasoning',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}]) as stream:\n with Path("stream-events.jsonl").open("w",encoding="utf-8") as log:\n for event in stream:\n payload=event.to_dict(mode="json")\n log.write(json.dumps(payload,ensure_ascii=False)+"\\n"); log.flush()\n print(json.dumps(payload,ensure_ascii=False))\n final=stream.get_final_completion()\n save_result(final.to_dict(mode="json"),"stream-result")\njson of SSE
Bewaar elk volledig teruggegeven antwoord, bestand en inhoudsonderdeel.
Bewaar elke keuze en de bijbehorende inhoud, toolaanroepen en redeneringen. Voeg in SSE delta’s samen per keuze-/toolindex en bewaar de uiteindelijke reden van beëindiging en de verbruiksgegevens.
Bewaar aanvraag-/antwoord-ID’s en headers. Er wordt geen algemene URL meegeleverd om teksttaken op te halen.
| Veld | Type |
|---|---|
Veldchoices[].index | Typeinteger |
Veldchoices[].message.content | Typestring|null |
Veldchoices[].message.tool_calls | Typetool_call[] |
Veldchoices[].message.reasoning_content | Typestring |
Veldchoices[].message.reasoning_details | Typeobject|array |
Veldchoices[].finish_reason | Typestring|null |
Veldusage | Typeobject |
| Antwoord | Voorwaarde | Volgende stap |
|---|---|---|
Antwoord400 · invalid_request_error | VoorwaardeVerplichte velden, de materiaalrepresentatie of een parameterwaarde zijn ongeldig | Volgende stapCorrigeer de aangegeven velden vóór een nieuwe aanmaakaanvraag. |
Ailoot Ultra sonar-reasoning
Gebruik de hierboven getoonde methodepaden.
sonar-reasoningSonar Reasoning combineert de zoekfunctie van Perplexity met redenering voor brongebaseerde vragen en vergelijkingen. Het levert een tekstantwoord dat op webbewijsmateriaal steunt, waarbij de oorspronkelijke vraag en bronverwijzingen voor controle behouden blijven.
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Sonar Reasoning is het met redenering versterkte zoekprofiel van Perplexity voor vragen die interpretatie van bewijsmateriaal vereisen, in plaats van een kort, losstaand feit. De maker onderscheidt het van Sonar Reasoning Pro en de andere Sonar-zoekprofielen. Het bruikbare resultaat is een tekstantwoord dat op bewijsmateriaal uit webbronnen steunt, waarbij redenering helpt om materiaal te vergelijken en een conclusie over de gestelde vraag te ontwikkelen.
Benoem het onderwerp, de vast te stellen feiten en de criteria die het antwoord moet gebruiken. Een productvergelijking kan vragen naar de gedocumenteerde mogelijkheden en beperkingen die relevant zijn voor één workflow. Een vraag over een gebeurtenis die zich ontwikkelt, moet de gebeurtenis, tijdsperiode en te verifiëren uitkomst benoemen. Geef het gewenste eindproduct aan: een korte uitleg, een tabel met bewijsmateriaal of een vergelijking die rond de te nemen beslissing is opgebouwd.
Houd aangeleverde achtergrondinformatie gescheiden van wat de zoekopdracht moet vaststellen. Vraag om een ontbrekende belangrijke voorwaarde open te laten in plaats van die met een aannemelijke aanname in te vullen. Een afgebakende vraag maakt het eenvoudiger te beoordelen of het opgehaalde materiaal die werkelijk beantwoordt, vooral wanneer meerdere bronnen verwante maar verschillende gevallen bespreken.
De fabrikant beschrijft Sonar Reasoning als onderdeel van zijn zoekfamilie met versterkte redenering. Gebruik het teruggegeven materiaal om alternatieven te vergelijken, een schijnbare tegenspraak op te lossen of uit te leggen waarom een conclusie uit het bewijsmateriaal volgt. Een door bronnen ondersteund redeneringsantwoord moet onderscheid maken tussen wat een pagina vermeldt en de gevolgtrekking die ontstaat door meerdere pagina's te combineren.
Vraag bij een vraag over vereisten welke bron het kenmerk documenteert en of de voorwaarden overeenkomen met het beoogde gebruik. Behoud bij een tijdsgevoelig feit de timing van de bron en de context waarin die de gebeurtenis beschrijft. Een pagina die relevant lijkt, kan over een eerdere versie of een ander geval gaan. Het verband met de vraag telt daarom zwaarder dan alleen de aanwezigheid van een bronverwijzing.
De Sonar-antwoordworkflow van de producent koppelt een antwoord aan bronverwijzingen. Bewaar die verwijzingen bij de passages die ze ondersteunen, zodat een andere lezer het bewijsmateriaal kan onderzoeken. Een vergelijkingstabel kan het item, de vermelde mogelijkheid, de ondersteunende bron en de onopgeloste voorwaarde bij elkaar houden. Controleer of het aangehaalde materiaal de exacte waarde vaststelt of slechts een verwante bewering ondersteunt.
Een bruikbare overdracht kan de oorspronkelijke vraag, het samengestelde antwoord en de ondersteunende bronnen bevatten. Behoud belangrijke namen, getallen en verschillen tussen bronnen wanneer je het resultaat in een afgewerkt document opneemt. Als het antwoord een doorslaggevend criterium onopgelost laat, richt een vervolgvraag dan specifiek op dat criterium in plaats van het niet-onderbouwde veld als voltooid te beschouwen.
Sonar Reasoning en Reasoning Pro zijn afzonderlijk benoemde profielen van de producent. De latere Agent API heeft eigen modellen, toolprimitieven en een eigen aanvraagformaat. Die nieuwere functies mogen daarom niet als de oorspronkelijke specificatie van dit profiel worden beschouwd. Bouw voort op het werkelijke antwoord en het bijbehorende bewijsmateriaal en behoud het geselecteerde profiel en de taakvoorwaarden wanneer je resultaten vergelijkt. De praktische waarde is een beoordeelbaar redeneringsresultaat dat voor een concrete onderzoeksvraag aan bronnen gekoppeld is.
POST /v1/messagestextjson, sse| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten sonar-reasoning | Standaard— |
Veldmessages | Typemessage[] | VereisteVereist | Waarden en limieten | Standaard— |
Veldmessages[].role | Typestring | VereisteVereist | Waarden en limieten user, assistant | Standaard— |
Veldmessages[].content | Typestring | VereisteVereist | Waarden en limieten | Standaard— |
Veldmax_tokens | Typeinteger | VereisteVereist | Waarden en limieten | Standaard— |
Veldstream | Typeboolean | VereisteOptioneel | Waarden en limieten | Standaardfalse |
Tekst · UTF-8-tekst
messages[].content als tekenreeks
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, messages, max_tokens |
Parameteroptional_controls | Contractstream |
Parametermaterial_types | Contracttext |
Parametertext_file_material | ContractLees het werkelijke UTF-8-document en plaats de tekst ervan in de aangegeven invoer of in de inhoudstekenreeks van een bericht. |
Levenscyclus: synchronous_or_streamed
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Tariefstaffel | Gefactureerde hoeveelheid | Kosten |
|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Gefactureerde hoeveelheid— | Kosten Invoer · Invoertokens $0.0044 / 1K tokens Uitvoer · Uitvoertokens $0.0176 / 1K tokens Invoer · Cache lezen $0 / 1K tokens Invoer · Cache schrijven $0 / 1K tokens Invoer · Cache schrijven, 1 uur — / 1K tokens |
| ConfiguratiePer aanvraag | Tariefstaffel— | Gefactureerde hoeveelheidéén verzoek | Kosten Invoer $0.01 per verzoek |
Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
{\n "model": "sonar-reasoning",\n "max_tokens": 128,\n "messages": [\n {\n "role": "user",\n "content": "Summarize the incident report."\n }\n ],\n "stream": false\n}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_TEXT_FILE:?Set your actual UTF-8 document}"\nexport AILOOT_TEXT_FILE\npython3 - <<'PY_REQUEST'\nimport json, os\nfrom pathlib import Path\n\nsource_file = Path(os.environ['AILOOT_TEXT_FILE'])\nif not source_file.is_file():\n raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')\ntext = source_file.read_text(encoding='utf-8')\nif not text.strip():\n raise SystemExit('Choose a document containing text')\npayload = {'model': 'sonar-reasoning', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}\npayload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\\n\\n' + text\nPath('request.json').write_text(json.dumps(payload, ensure_ascii=False), encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/messages \\\n -H "x-api-key: $AILOOT_API_KEY" -H 'anthropic-version: 2023-06-01' -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\n\nresult = json.loads(Path('result.json').read_text(encoding='utf-8'))\nprint(json.dumps(result, ensure_ascii=False, indent=2))\nPY_RESULT\nimport json, os\nfrom pathlib import Path\n\nsource_file = Path(os.environ['AILOOT_TEXT_FILE'])\nif not source_file.is_file():\n raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')\ntext = source_file.read_text(encoding='utf-8')\nif not text.strip():\n raise SystemExit('Choose a document containing text')\npayload = {'model': 'sonar-reasoning', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}\npayload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\\n\\n' + text\nfrom urllib.request import Request, urlopen\nfrom urllib.error import HTTPError\n\napi_key = os.environ['AILOOT_API_KEY']\nif not api_key.strip():\n raise SystemExit('Set AILOOT_API_KEY before making a request')\nheaders = {'x-api-key': 'PLACEHOLDER_KEY', 'anthropic-version': '2023-06-01', 'Content-Type': 'application/json'}\nheaders['x-api-key'] = api_key\nrequest = Request('https://api.ailoot.ai/v1/messages', data=json.dumps(payload, ensure_ascii=False).encode('utf-8'), headers=headers, method='POST')\ntry:\n with urlopen(request, timeout=120) as response:\n raw = response.read()\n Path('response-headers.txt').write_text(str(response.headers), encoding='utf-8')\nexcept HTTPError as error:\n Path('result.json').write_bytes(error.read())\n Path('response-headers.txt').write_text(str(error.headers), encoding='utf-8')\n raise\nPath('result.json').write_bytes(raw)\nimport json\nfrom pathlib import Path\n\nresult = json.loads(Path('result.json').read_text(encoding='utf-8'))\nprint(json.dumps(result, ensure_ascii=False, indent=2))\nJSON of SSE
Bewaar elk volledig teruggegeven antwoord, bestand en inhoudsonderdeel.
Bewaar alle inhoudsblokken, handtekeningen van redeneringen en werkelijke toolgebruik-ID’s. Voeg alle SSE-blokdelta’s samen; het eerste tekstblok is niet de volledige uitvoer.
Bewaar aanvraag-/antwoord-ID’s en headers. Er wordt geen algemene URL meegeleverd om teksttaken op te halen.
| Veld | Type |
|---|---|
Veldid | Typestring |
Veldmodel | Typestring |
Veldcontent[] | Typetext|thinking|tool_use|other content block |
Veldstop_reason | Typestring|null |
Veldusage | Typeobject |
| Antwoord | Voorwaarde | Volgende stap |
|---|---|---|
Antwoord400 · invalid_request_error | VoorwaardeVerplichte velden, de materiaalrepresentatie of een parameterwaarde zijn ongeldig | Volgende stapCorrigeer de aangegeven velden vóór een nieuwe aanmaakaanvraag. |
Ailoot Ultra sonar-reasoning
Gebruik de hierboven getoonde methodepaden.
Technisch voorbeeld in het Engels
Research a protocol distinction\n\nFind the IETF HTTP Semantics specification and explain how HEAD differs from GET for response content and metadata. Prepare a small evidence table with official source references, then give one practical use of HEAD. Distinguish what the specification requires from your example and leave any server-specific behavior unresolved.A source-backed comparison table and a clearly labelled application example with citations.Inspect the cited specification sections and check that each claim concerns the actual GET/HEAD distinction.