> ## Documentation Index > Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt > Use this file to discover all available pages before exploring further. # Openai V1 Responses ## OpenAPI ````yaml /openapi/openai.json post /openai/responses openapi: 3.0.0 info: title: OpenAI generation version: 1.0.0 description: API reference for OpenAI generation on Ace Data Cloud. servers: - url: https://api.acedata.cloud description: Ace Data Cloud API security: - bearerAuth: [] paths: /openai/responses: post: summary: Openai V1 Responses operationId: OpenaicreateOpenaiResponses parameters: - in: header name: accept schema: enum: - application/json - text/event-stream type: string required: false description: Openai Responses Param Accept requestBody: content: application/json: schema: type: object required: - model - input properties: 'n': type: number default: 1 example: 1 maximum: 128 minimum: 1 nullable: true description: Openai Responses N model: enum: - gpt-6-astra - gpt-5.6-luna - gpt-5.6-terra - gpt-5.6-sol - gpt-5.5 - gpt-5.5-pro - gpt-5.4 - gpt-5.4-mini - gpt-5.4-nano - gpt-5.4-pro - gpt-5.1 - gpt-5.1-all - gpt-5 - gpt-5-mini - gpt-5-nano - gpt-4 - gpt-4-all - gpt-4-turbo - gpt-4-turbo-preview - gpt-4-vision-preview - gpt-4.1 - gpt-4.1-2025-04-14 - gpt-4.1-mini - gpt-4.1-mini-2025-04-14 - gpt-4.1-nano - gpt-4.1-nano-2025-04-14 - gpt-4.5-preview - gpt-4.5-preview-2025-02-27 - gpt-4o - gpt-4o-2024-05-13 - gpt-4o-2024-08-06 - gpt-4o-2024-11-20 - gpt-4o-all - gpt-4o-image - gpt-4o-mini - gpt-4o-mini-2024-07-18 - gpt-4o-mini-search-preview - gpt-4o-mini-search-preview-2025-03-11 - gpt-4o-search-preview - gpt-4o-search-preview-2025-03-11 - gpt-35-turbo-16k - o1 - o1-2024-12-17 - o1-all - o1-mini - o1-mini-2024-09-12 - o1-mini-all - o1-preview - o1-preview-2024-09-12 - o1-preview-all - o1-pro - o1-pro-2025-03-19 - o1-pro-all - o3 - o3-2025-04-16 - o3-all - o3-mini - o3-mini-2025-01-31 - o3-mini-2025-01-31-high - o3-mini-2025-01-31-low - o3-mini-2025-01-31-medium - o3-mini-all - o3-mini-high - o3-mini-high-all - o3-mini-low - o3-mini-medium - o3-pro - o3-pro-2025-06-10 - o4-mini - o4-mini-2025-04-16 - o4-mini-all - o4-mini-high-all type: string example: gpt-4o-mini description: Openai Responses Model background: type: boolean default: false nullable: true description: Openai Responses Background stream: type: boolean default: false nullable: true description: Openai Responses Stream input: $ref: '#/components/schemas/ResponsesInput' description: Openai Responses Input 2 example: - type: message role: user content: Inspect the workspace. - type: custom_tool_call call_id: call_123 namespace: workspace name: exec input: read package.json - type: custom_tool_call_output call_id: call_123 output: package contents tools: type: array minItems: 1 items: $ref: '#/components/schemas/ResponsesTool' description: Openai Responses Tools max_tokens: type: number nullable: true description: Openai Responses Max Tokens temperature: type: number default: 1 example: 1 maximum: 2 minimum: 0 nullable: true description: Openai Responses Temperature response_format: type: object properties: type: enum: - text - json_object type: string default: text example: json_object description: Openai Responses Response Format Type description: Openai Responses Response Format tool_choice: oneOf: - type: string enum: - none - auto - required - type: object additionalProperties: true description: >- Openapi.Ed972A38Ecef4Fcbaf33750De42D25Dc.Tool Choice.C7B5D99A6584 parallel_tool_calls: type: boolean default: true include: type: array items: type: string reasoning: type: object additionalProperties: true text: type: object additionalProperties: true max_output_tokens: type: integer minimum: 1 nullable: true store: type: boolean default: true nullable: true stream_options: type: object additionalProperties: true example: 'n': 1 model: gpt-4o-mini input: - role: user content: A cute cat playing piano temperature: 1 response_format: type: json_object required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/ResponsesResponse' example: id: resp_123 object: response created_at: 1700000000 status: completed model: gpt-5.6-luna output: - id: msg_123 type: message role: assistant status: completed content: - type: output_text text: Done. annotations: [] usage: input_tokens: 12 output_tokens: 3 total_tokens: 15 text/event-stream: schema: $ref: '#/components/schemas/ResponsesStreamEvent' example: >+ event: response.completed data: {"type":"response.completed","response":{"id":"resp_123","object":"response","status":"completed","model":"gpt-5.6-luna","output":[]}} description: Openai Responses Response 200 2 '400': content: application/json: schema: oneOf: - type: object example: error: code: token_mismatched message: The specified token is not matched with API. trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab properties: error: type: object properties: code: type: string example: token_mismatched description: Openai Responses Response 400 Error Code message: type: string example: The specified token is not matched with API. description: Openai Responses Response 400 Error Message trace_id: type: string description: Openai Responses Response 400 Trace Id - type: object example: error: code: api_not_implemented message: The API is not implemented. trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab properties: error: type: object properties: code: type: string example: api_not_implemented description: Openai Responses Response 400 Error Code 2 message: type: string example: The API is not implemented. description: Openai Responses Response 400 Error Message 2 trace_id: type: string description: Openai Responses Response 400 Trace Id 2 description: Openai Responses Response 400 '401': content: application/json: schema: oneOf: - type: object example: error: code: invalid_token message: The specified token is invalid or wrong. trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab properties: error: type: object properties: code: type: string example: invalid_token description: Openai Responses Response 401 Error Code message: type: string example: The specified token is invalid or wrong. description: Openai Responses Response 401 Error Message trace_id: type: string description: Openai Responses Response 401 Trace Id description: Openai Responses Response 401 '429': content: application/json: schema: oneOf: - type: object example: error: code: too_many_requests message: You have exceeded the rate limit. trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab properties: error: type: object properties: code: type: string example: too_many_requests description: Openai Responses Response 429 Error Code message: type: string example: You have exceeded the rate limit. description: Openai Responses Response 429 Error Message trace_id: type: string description: Openai Responses Response 429 Trace Id description: Openai Responses Response 429 '500': content: application/json: schema: oneOf: - type: object example: error: code: api_error message: Internal server error. trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab properties: error: type: object properties: code: type: string example: api_error description: Openai Responses Response 500 Error Code message: type: string example: Internal server error. description: Openai Responses Response 500 Error Message trace_id: type: string description: Openai Responses Response 500 Trace Id description: Openai Responses Response 500 security: - bearerAuth: [] components: schemas: ResponsesInput: oneOf: - type: string - type: array minItems: 1 items: $ref: '#/components/schemas/ResponsesInputItem' description: Openapi.Ed972A38Ecef4Fcbaf33750De42D25Dc.Responsesinput.14Feedcd5C3D ResponsesTool: oneOf: - $ref: '#/components/schemas/ResponsesCustomTool' - $ref: '#/components/schemas/ResponsesFunctionTool' - $ref: '#/components/schemas/ResponsesNamespaceTool' - $ref: '#/components/schemas/ResponsesOpenTool' discriminator: propertyName: type ResponsesResponse: type: object required: - id - object - status - model - output properties: id: type: string object: type: string enum: - response created_at: type: integer status: type: string enum: - completed - failed - in_progress - incomplete - queued - cancelled model: type: string output: type: array items: $ref: '#/components/schemas/ResponsesOutputItem' output_text: type: string usage: allOf: - $ref: '#/components/schemas/ResponsesUsage' nullable: true error: type: object nullable: true additionalProperties: true additionalProperties: true ResponsesStreamEvent: type: object required: - type properties: type: type: string description: Openapi.Ed972A38Ecef4Fcbaf33750De42D25Dc.Type.Fab6416D3441 response: $ref: '#/components/schemas/ResponsesResponse' item: $ref: '#/components/schemas/ResponsesOutputItem' output_index: type: integer delta: type: string additionalProperties: true ResponsesInputItem: oneOf: - $ref: '#/components/schemas/ResponsesMessageInput' - $ref: '#/components/schemas/ResponsesFunctionToolCall' - $ref: '#/components/schemas/ResponsesFunctionToolCallOutput' - $ref: '#/components/schemas/ResponsesCustomToolCall' - $ref: '#/components/schemas/ResponsesCustomToolCallOutput' - $ref: '#/components/schemas/ResponsesAdditionalTools' - $ref: '#/components/schemas/ResponsesOpenInputItem' discriminator: propertyName: type ResponsesCustomTool: type: object required: - type - name properties: type: type: string enum: - custom name: type: string description: type: string format: type: object additionalProperties: true ResponsesFunctionTool: type: object required: - type - name properties: type: type: string enum: - function name: type: string description: type: string parameters: type: object nullable: true additionalProperties: true strict: type: boolean nullable: true ResponsesNamespaceTool: type: object required: - type - name - description - tools properties: type: type: string enum: - namespace name: type: string minLength: 1 description: Openapi.Ed972A38Ecef4Fcbaf33750De42D25Dc.Name.E87F9B9F039A description: type: string tools: type: array minItems: 1 items: oneOf: - $ref: '#/components/schemas/ResponsesCustomTool' - $ref: '#/components/schemas/ResponsesFunctionTool' discriminator: propertyName: type ResponsesOpenTool: type: object required: - type properties: type: type: string not: enum: - custom - function - namespace additionalProperties: true description: Openapi.Ed972A38Ecef4Fcbaf33750De42D25Dc.Responsesopentool.7F928862419E ResponsesOutputItem: oneOf: - $ref: '#/components/schemas/ResponsesOutputMessage' - $ref: '#/components/schemas/ResponsesFunctionToolCall' - $ref: '#/components/schemas/ResponsesCustomToolCall' - $ref: '#/components/schemas/ResponsesOpenOutputItem' discriminator: propertyName: type ResponsesUsage: type: object required: - input_tokens - output_tokens - total_tokens properties: input_tokens: type: integer output_tokens: type: integer total_tokens: type: integer input_tokens_details: type: object additionalProperties: true output_tokens_details: type: object additionalProperties: true additionalProperties: true ResponsesMessageInput: type: object required: - role - content properties: type: type: string enum: - message role: type: string enum: - user - assistant - system - developer content: oneOf: - type: string - type: array items: type: object additionalProperties: true phase: type: string nullable: true ResponsesFunctionToolCall: type: object required: - type - call_id - name - arguments properties: type: type: string enum: - function_call id: type: string call_id: type: string description: Openapi.Ed972A38Ecef4Fcbaf33750De42D25Dc.Call Id.4A7F97Cae969 name: type: string arguments: type: string status: type: string additionalProperties: true ResponsesFunctionToolCallOutput: type: object required: - type - output properties: type: type: string enum: - function_call_output id: type: string call_id: type: string nullable: true description: Openapi.Ed972A38Ecef4Fcbaf33750De42D25Dc.Call Id.2De867Df3989 output: oneOf: - type: string - type: array items: type: object additionalProperties: true name: type: string nullable: true description: Openapi.Ed972A38Ecef4Fcbaf33750De42D25Dc.Name.C324F7126A7C namespace: type: string nullable: true description: Openapi.Ed972A38Ecef4Fcbaf33750De42D25Dc.Namespace.Bf3297183432 additionalProperties: true ResponsesCustomToolCall: type: object required: - type - call_id - name - input properties: type: type: string enum: - custom_tool_call id: type: string call_id: type: string description: Openapi.Ed972A38Ecef4Fcbaf33750De42D25Dc.Call Id.8C6Ca8028A3E name: type: string namespace: type: string description: Openapi.Ed972A38Ecef4Fcbaf33750De42D25Dc.Namespace.713201D1840C input: type: string additionalProperties: true ResponsesCustomToolCallOutput: type: object required: - type - call_id - output properties: type: type: string enum: - custom_tool_call_output id: type: string call_id: type: string description: Openapi.Ed972A38Ecef4Fcbaf33750De42D25Dc.Call Id.56Bb02E66Ff9 output: oneOf: - type: string - type: array items: type: object additionalProperties: true additionalProperties: true ResponsesAdditionalTools: type: object required: - type - role - tools properties: type: type: string enum: - additional_tools role: type: string enum: - developer tools: type: array minItems: 1 items: $ref: '#/components/schemas/ResponsesTool' ResponsesOpenInputItem: type: object required: - type properties: type: type: string not: enum: - message - function_call - function_call_output - custom_tool_call - custom_tool_call_output - additional_tools additionalProperties: true description: >- Openapi.Ed972A38Ecef4Fcbaf33750De42D25Dc.Responsesopeninputitem.E574D2Efca8F ResponsesOutputMessage: type: object required: - type - role - content properties: type: type: string enum: - message id: type: string role: type: string enum: - assistant status: type: string content: type: array items: type: object additionalProperties: true additionalProperties: true ResponsesOpenOutputItem: type: object required: - type properties: type: type: string not: enum: - message - function_call - custom_tool_call additionalProperties: true description: >- Openapi.Ed972A38Ecef4Fcbaf33750De42D25Dc.Responsesopenoutputitem.03A8Aa0Cff8B securitySchemes: bearerAuth: type: http scheme: bearer description: API token from https://platform.acedata.cloud ````