Using GPT 6 Astra in your workflow
Sorceress brings OpenAI models into a shared API catalog. Select this model explicitly, check its supported inputs, and keep your API key on your server. Model capabilities differ; the schema and options on this page describe this entry rather than every model from the same brand.
- Draft, explain and refine content in a conversation.
- Use a consistent chat endpoint while choosing a model suited to your task.
Credits & pricing
560 credits / M input tokens, 2800 / M output
1 credit = $0.01 · Successful work is billed on completion.Token pricing
Charged for actual token usage, rounded up to 0.001 credits with a 0.02-credit minimum per reply.
Review the supported inputs for duration, quantity and other usage-based charges before submitting. Read the billing guide →
Inputs and supported options
{
"type": "object",
"required": [
"model",
"messages"
],
"properties": {
"model": {
"type": "string",
"title": "Model",
"enum": [
"gpt-6-astra"
],
"default": "gpt-6-astra"
},
"messages": {
"type": "array",
"title": "Messages",
"description": "The conversation so far, oldest first. Content is a string or text / image_url parts. Video files use image_url only on models whose chat_capabilities.video_input is true.",
"minItems": 1,
"items": {
"type": "object",
"required": [
"role"
],
"properties": {
"role": {
"type": "string",
"title": "Role",
"enum": [
"system",
"developer",
"user",
"assistant",
"tool"
]
},
"content": {
"title": "Content",
"oneOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"text",
"image_url"
]
},
"text": {
"type": "string"
},
"image_url": {
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"detail": {
"type": "string",
"enum": [
"auto",
"low",
"high"
]
},
"mime_type": {
"type": "string",
"description": "Optional image or video MIME type for a hosted reference."
}
}
}
}
}
}
]
},
"name": {
"type": "string",
"title": "Name"
},
"tool_calls": {
"type": "array",
"title": "Tool calls",
"items": {
"type": "object"
}
},
"tool_call_id": {
"type": "string",
"title": "Tool call ID"
}
}
}
},
"tools": {
"type": "array",
"title": "Tools",
"description": "Function tools the model may call: { type: \"function\", function: { name, description, parameters } }.",
"items": {
"type": "object"
}
},
"tool_choice": {
"title": "Tool choice",
"description": "\"auto\", \"none\", \"required\" or { type: \"function\", function: { name } }.",
"oneOf": [
{
"type": "string",
"enum": [
"auto",
"none",
"required"
]
},
{
"type": "object"
}
]
},
"stream": {
"type": "boolean",
"title": "Stream",
"description": "Server-sent events; the final chunk carries usage and the credits charged.",
"default": false
},
"max_tokens": {
"type": "integer",
"title": "Max tokens",
"description": "Upper bound on the number of tokens generated for the reply (reasoning tokens included).",
"minimum": 1,
"maximum": 128000
},
"temperature": {
"type": "number",
"title": "Temperature",
"minimum": 0,
"maximum": 2
},
"top_p": {
"type": "number",
"title": "Top p",
"minimum": 0,
"maximum": 1
},
"stop": {
"title": "Stop",
"oneOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
},
"maxItems": 4
}
]
},
"response_format": {
"type": "object",
"title": "Response format",
"description": "{ type: \"text\" | \"json_object\" }",
"properties": {
"type": {
"type": "string",
"enum": [
"text",
"json_object"
]
}
}
},
"reasoning_effort": {
"type": "string",
"title": "Reasoning",
"enum": [
"low",
"medium",
"high",
"xhigh",
"max"
],
"description": "Choose a supported reasoning setting. Omit to use the model default."
}
}
}API request template
Replace placeholders and choose valid values from the input contract.
POST /api/v1/chat/completions
Authorization: Bearer $SORCERESS_API_KEY
Content-Type: application/json
{
"model": "gpt-6-astra",
"messages": [
{
"role": "user",
"content": "Hello"
}
]
}Completion, results and billing
Save the job identifier returned by asynchronous requests and poll the jobs endpoint until the job succeeds or fails. Do not resubmit a generation just because it is still processing. Chat returns a completed reply and usage details. A multi-step workflow can include separately billed successful steps even if a later step fails. Keep returned asset links with your project, and consult each action for its output format.
Coding agents can discover the current catalog and input requirements from the Sorceress agent instructions. Use a Sorceress key; provider credentials stay on the server.