API

Tagabuo ng code para sa API

Pumili ng wika at gawain para makakuha ng code na sumusunod sa dokumentasyon ng Reflection, kasama ang mga detalyeng naiiba sa OpenAI.

Beam-501B-A23B
Wika
reasoning_effort
Kapag walang laman, gagamitin ang default ng API. Kasama sa limitasyong ito ang mga token para sa pangangatwiran.

Pag-install at API key

bash
pip install openai
export REFLECTION_API_KEY="<your API key>"

Code

main.py
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.reflection.ai/openai/v1",
    api_key=os.environ["REFLECTION_API_KEY"],
)

messages = [
    {"role": "user", "content": "Write a short poem about sparse experts."},
]

stream = client.chat.completions.create(
    model="Beam-501B-A23B",
    messages=messages,
    reasoning_effort="medium",
    stream=True,
    stream_options={"include_usage": True},
)

for chunk in stream:
    if not chunk.choices:  # the last chunk carries only usage
        print("\n", chunk.usage)
        continue
    delta = chunk.choices[0].delta
    reasoning = getattr(delta, "reasoning_content", None)
    if reasoning:
        print(reasoning, end="", flush=True)
    if delta.content:
        print(delta.content, end="", flush=True)
Nag-i-stream muna ang pangangatwiran sa delta.reasoning_content, kasunod ang sagot sa delta.content. Nagdaragdag ang include_usage ng huling chunk na naglalaman ng bilang ng mga token.

Suporta sa parameter

Sinusuportahan
  • model, messages na may mga role na system, developer, user, assistant at tool
  • reasoning_effort: low, medium, high, xhigh, max
  • stream at stream_options.include_usage
  • tools, tool_choice, parallel_tool_calls
  • response_format: json_object at json_schema, kasama ang strict
  • temperature, top_p, frequency_penalty, presence_penalty, seed, max_completion_tokens
Hindi sinusuportahan
  • Mga input ng larawan, audio at file
  • n maliban sa 1, logprobs, logit_bias
  • user, metadata, audio at prediction ay nagbabalik ng error
  • Tinatanggap ang stop pero wala itong epekto
  • Mga API ng Responses, Embeddings, Images, Audio, Files, Batch at Assistants

Mga error na dapat asikasuhin

Status at codeAno ang ibig sabihin nito
400 unsupported_valueIsang value ng reasoning_effort na hindi tinatanggap ng modelo, gaya ng none o minimal.
400 missing_required_parameterNaipadala ang naunang mensahe ng assistant nang wala ang reasoning_content nito, o nawawala ang json_schema.
401Nawawala o hindi valid ang API key.
429 rate_limit_exceededNaabot ang limitasyon kada minuto o araw. Maghintay sa Retry-After.
503 inference_capacity_unavailablePansamantalang naubos ang capacity. Subukang muli pagkatapos ng Retry-After.

Mga pinagmulan: openai-compatibility · reasoning · tool-calling · structured-outputs · errors