Skip to main content
POST
Sử dụng Responses API để gửi văn bản, hình ảnh, tệp và lịch sử hội thoại bằng gpt-6-astra. Các ví dụ cũng minh họa web search, lệnh gọi hàm tùy chỉnh, đầu ra có cấu trúc, lập luận và streaming.
Tài liệu tham khảo OpenAI Responses mô tả định dạng API đầy đủ; các ví dụ ở đây cấu hình định dạng đó cho CometAPI.

Tiếp tục cuộc hội thoại

Đối với cuộc hội thoại chỉ có văn bản, hãy giữ lại các tin nhắn của người dùng và các phản hồi văn bản của trợ lý, sau đó thêm tin nhắn người dùng tiếp theo:
response.output_text là một thuộc tính tiện lợi của SDK kết hợp văn bản của trợ lý từ phản hồi. Các cuộc hội thoại dùng function calling cũng cần các mục lệnh gọi công cụ và kết quả của chúng, như mô tả bên dưới.
Thêm công cụ web_search để tìm kiếm thông tin và đưa vào trích dẫn nguồn:
Kiểm tra các mục web_search_call được trả về và chú thích URL của tin nhắn khi ứng dụng của bạn cần kết quả tìm kiếm hoặc trích dẫn. Các công cụ tích hợp sẵn khác cần cấu hình riêng; xem hướng dẫn công cụ OpenAI.

Gọi các hàm tùy chỉnh

Xác định các đối số của hàm và để mô hình yêu cầu gọi hàm:
Lời gọi hàm xuất hiện dưới dạng một mục đầu ra function_call. Trường arguments của mục này là một chuỗi được mã hóa JSON. Thực thi hàm của bạn, sau đó tạo yêu cầu tiếp theo từ dữ liệu đầu vào ban đầu và các mục đầu ra được trả về, không bao gồm các trường id của response item. Giữ lại name, argumentscall_id của hàm, rồi thêm một mục function_call_outputcall_id tương ứng và kết quả của bạn trong output.

Yêu cầu đầu ra có cấu trúc

Sử dụng text.format để yêu cầu JSON tuân theo một schema:
Kiểm tra để đảm bảo phản hồi đã hoàn tất và không từ chối yêu cầu trước khi phân tích cú pháp JSON. Phản hồi chạm đến giới hạn Token đầu ra có thể không hoàn chỉnh.

Cấu hình suy luận

Đặt reasoning.effort để chọn mức độ nỗ lực suy luận của model:
Các ví dụ sử dụng low cho các tác vụ chung và high cho ví dụ về suy luận. max_output_tokens bao gồm cả token suy luận và token đầu ra hiển thị.

Stream phản hồi

Đặt stream thành true để nhận các sự kiện do máy chủ gửi:
Phản hồi văn bản bao gồm các sự kiện trong vòng đời như response.created, response.in_progressresponse.completed. Văn bản đến trong các sự kiện response.output_text.delta. Các sự kiện công cụ và suy luận phụ thuộc vào yêu cầu, vì vậy hãy xử lý sự kiện theo type của chúng thay vì giả định mọi phản hồi đều có cùng một trình tự.

Ủy quyền

Authorization
string
header
bắt buộc

Bearer token authentication. Use your CometAPI key.

Nội dung

application/json
model
string
mặc định:gpt-6-astra
bắt buộc

Model ID to use for this request. See the Models page for current options.

Ví dụ:

"gpt-6-astra"

input
bắt buộc

Text, image, or file inputs to the model, used to generate a response. Can be a simple string for text-only input, or an array of input items for multimodal content (images, files) and multi-turn conversations.

instructions
string

A system (or developer) message inserted into the model's context. When used with previous_response_id, instructions from the previous response are not carried over — this makes it easy to swap system messages between turns.

background
boolean

Whether to run the model response in the background. Background responses do not return output directly — you retrieve the result later via the response ID.

context_management
object[]

Context management configuration for this request. Controls how the model manages context when the conversation exceeds the context window.

conversation

The conversation this response belongs to. Items from the conversation are prepended to input for context. Input and output items are automatically added to the conversation after the response completes. Cannot be used with previous_response_id.

include
enum<string>[]

Additional output data to include in the response. Use this to request extra information that is not included by default.

Tùy chọn có sẵn:
web_search_call.action.sources,
code_interpreter_call.outputs,
computer_call_output.output.image_url,
file_search_call.results,
message.input_image.image_url,
message.output_text.logprobs,
reasoning.encrypted_content
max_output_tokens
integer

An upper bound for the number of tokens that can be generated for a response, including visible output tokens and reasoning tokens.

max_tool_calls
integer

The maximum number of total calls to built-in tools that can be processed in a response. This limit applies across all built-in tool calls, not per individual tool. Any further tool call attempts by the model will be ignored.

metadata
object

Set of up to 16 key-value pairs that can be attached to the response. Useful for storing additional information in a structured format. Keys have a maximum length of 64 characters; values have a maximum length of 512 characters.

parallel_tool_calls
boolean

Whether to allow the model to run tool calls in parallel.

previous_response_id
string

An ID for a stored response that is accessible to the selected model and request context. Cannot be combined with conversation. The conversation-history example sends prior input and output items explicitly.

prompt
object

Reference to a prompt template and its variables.

prompt_cache_key
string

A key used to cache responses for similar requests, helping optimize cache hit rates. Replaces the deprecated user field for caching purposes.

prompt_cache_retention
enum<string>
không còn sử dụng

Legacy prompt-cache retention setting. Refer to the selected model documentation for prompt_cache_options and supported retention settings.

Tùy chọn có sẵn:
in_memory,
24h
reasoning
object

Reasoning configuration for the selected model.

safety_identifier
string

A stable identifier for your end-users, used to help detect policy violations. Should be a hashed username or email — do not send identifying information directly.

Maximum string length: 64
service_tier
enum<string>

Specifies the processing tier for the request. When set, the response will include the actual service_tier used.

  • auto: Uses the tier configured in project settings (default behavior).
  • default: Standard pricing and performance.
  • flex: Flexible processing with potential cost savings.
  • priority: Priority processing with faster response times.
Tùy chọn có sẵn:
auto,
default,
flex,
priority
store
boolean

Request response storage for later retrieval, when supported by the selected model and request context.

stream
boolean

If set to true, the response data will be streamed to the client as it is generated using server-sent events (SSE). Events include response.created, response.output_text.delta, response.completed, and more.

stream_options
object

Options for streaming responses. Only set this when stream is true.

temperature
number

Sampling temperature. Omit this field for GPT-6 Astra.

Phạm vi bắt buộc: 0 <= x <= 2
text
object

Configuration for text output. Use this to request structured JSON output via JSON mode or JSON Schema.

tool_choice

Controls how the model selects which tool(s) to call.

  • auto (default): The model decides whether and which tools to call.
  • none: The model will not call any tools.
  • required: The model must call at least one tool.
  • An object specifying a particular tool to use.
tools
object[]

Tools available to the model. This page demonstrates web_search and custom function tools. Other tool types require their own configuration; see the official tool reference.

top_logprobs
integer

Number of token alternatives to include for models supporting log probabilities. Requires message.output_text.logprobs in include. Omit for GPT-6 Astra.

Phạm vi bắt buộc: 0 <= x <= 20
top_p
number

Nucleus sampling threshold. Omit this field for GPT-6 Astra. For sampling overrides, adjust either top_p or temperature.

Phạm vi bắt buộc: 0 <= x <= 1
truncation
enum<string>

The truncation strategy for handling inputs that exceed the model's context window.

  • auto: The model truncates the input by dropping items from the beginning of the conversation to fit.
  • disabled (default): The request fails with a 400 error if the input exceeds the context window.
Tùy chọn có sẵn:
auto,
disabled
user
string
không còn sử dụng

Deprecated. Use safety_identifier and prompt_cache_key instead. A stable identifier for your end-user.

Phản hồi

200 - application/json

The generated Response object.

id
string

Unique identifier for the response.

Ví dụ:

"resp_example"

object
enum<string>

The object type, always response.

Tùy chọn có sẵn:
response
Ví dụ:

"response"

created_at
integer

Unix timestamp (in seconds) of when the response was created.

Ví dụ:

1788763707

status
enum<string>

The status of the response.

Tùy chọn có sẵn:
completed,
in_progress,
failed,
cancelled,
queued,
incomplete
Ví dụ:

"completed"

background
boolean

Whether the response was run in the background.

Ví dụ:

false

completed_at
integer | null

Unix timestamp of when the response was completed, or null if still in progress.

Ví dụ:

1788763711

error
object | null

Error information if the response failed, or null on success.

incomplete_details
object | null

Details about why the response is incomplete, if applicable.

instructions
string | null

The system instructions used for this response.

max_output_tokens
integer | null

The maximum output token limit that was applied.

model
string

The model used for the response.

Ví dụ:

"gpt-6-astra"

output
object[]

An array of output items generated by the model. Each item can be a message, function call, or other output type.

parallel_tool_calls
boolean

Whether parallel tool calls were enabled.

previous_response_id
string | null

The ID of the previous response, if this is a multi-turn conversation.

reasoning
object

The reasoning configuration that was used.

service_tier
string

The service tier actually used to process the request.

store
boolean

Whether the response was stored.

temperature
number

The temperature value used.

text
object

The text configuration used.

tool_choice

The tool choice setting used.

tools
object[]

The tools that were available for this response.

top_p
number

The top_p value used.

truncation
string

The truncation strategy used.

usage
object

Token usage statistics for this response.

user
string | null

The user identifier, if provided.

metadata
object

The metadata attached to this response.

content_filters
array | null

Content filter results applied to the response, if any.

frequency_penalty
number

The frequency penalty applied to the request.

max_tool_calls
integer | null

Maximum number of tool calls allowed, if set.

presence_penalty
number

The presence penalty applied to the request.

prompt_cache_key
string | null

Cache key for prompt caching, if applicable.

prompt_cache_retention
string | null

Prompt cache retention policy, if applicable.

safety_identifier
string | null

Safety system identifier for the response, if applicable.

top_logprobs
integer

Number of top log probabilities returned per token position.

Lần sửa đổi cuối 8 tháng 9, 2026