Skip to main content
Pioneer exposes a set of OpenAI-compatible endpoints so you can use your existing OpenAI SDK code against your fine-tuned Pioneer models with minimal changes. Set base_url to https://api.pioneer.ai/v1, authenticate with your Pioneer API key, and pass your training job ID as the model. Pioneer-specific fields like schema can be passed via extra_body in the Python SDK or included directly in the JSON body.
If you already have an OpenAI integration, switching to Pioneer requires only two changes: update base_url and swap in your Pioneer API key. Everything else — SDK methods, streaming, message format — stays the same.

​
Endpoints

MethodPathDescription
POST/v1/chat/completionsChat completions
POST/v1/completionsText completions
POST/v1/responsesResponses API
GET/v1/modelsList available models

​
Configure the OpenAI SDK

Point the SDK at Pioneer’s base URL and supply your Pioneer API key: 
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.pioneer.ai/v1"
)

​
Chat completions

POST /v1/chat/completions accepts the same request shape as the OpenAI Chat Completions API. Pass your training job ID as model and include Pioneer-specific fields like schema in the request body or via extra_body. 
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.pioneer.ai/v1"
)

response = client.chat.completions.create(
    model="YOUR_TRAINING_JOB_ID",
    messages=[
        {
            "role": "user",
            "content": "Extract entities from: Apple launched the iPhone."
        }
    ],
    extra_body={
        "schema": {
            "entities": ["organization", "product"]
        }
    }
)

print(response.choices[0].message.content)

​
Text completions

POST /v1/completions supports the legacy completions format with a prompt field. 
response = client.completions.create(
    model="YOUR_TRAINING_JOB_ID",
    prompt="Extract the company names from: Apple and Google announced a partnership.",
    extra_body={
        "schema": {
            "entities": ["organization"]
        }
    }
)

print(response.choices[0].text)

​
List available models

Use GET /v1/models to retrieve the list of models you can use with these endpoints. 
models = client.models.list()
for model in models.data:
    print(model.id)

​
Streaming

All completions endpoints support streaming. Set stream=True in the SDK or "stream": true in the request body. 
stream = client.chat.completions.create(
    model="YOUR_TRAINING_JOB_ID",
    messages=[{"role": "user", "content": "Summarize the following article: ..."}],
    stream=True
)

for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="")

​
Passing Pioneer-specific fields

The schema field is a Pioneer extension. In the OpenAI Python SDK, pass it via extra_body so it is included in the request without affecting SDK validation. In a raw HTTP request, include it at the top level of the JSON body alongside standard fields like model and messages.