{"openapi":"3.0.0","info":{"description":"Nebius Token Factory — OpenAI-compatible inference platform with chat completions, text completions, embeddings, reranking, image generation, responses, files, fine-tuning, datasets, and dedicated endpoints.","version":[{"name":"v1","value":"v1"}]},"servers":[{"description":"Nebius Token Factory — OpenAI-compatible inference platform with chat completions, text completions, embeddings, reranking, image generation, responses, files, fine-tuning, datasets, and dedicated endpoints.","url":"https://api.apirails.com/tokenfactory"}],"paths":{"/fine_tuning/models/spec-draft":{"get":{"tags":["Fine-Tuning"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/fine_tuning/models/spec-draft"},"summary":"List spec-draft trainable models","description":"List spec-draft trainable models","security":[{"bearerAuth":[]}]}},"/v0/dedicated_endpoints":{"get":{"tags":["Dedicated Endpoints"],"parameters":[{"name":"ai_project_id","in":"query","description":"Project ID to list endpoints","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v0/dedicated_endpoints"},"summary":"List Dedicated Endpoints","description":"List Dedicated Endpoints","security":[{"bearerAuth":[]}]},"post":{"tags":["Dedicated Endpoints"],"parameters":[{"name":"ai_project_id","in":"query","description":"Project ID to create endpoint","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v0/dedicated_endpoints"},"summary":"Create Dedicated Endpoint","description":"Create Dedicated Endpoint","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"name":{"type":"string","description":"Name name","required":true},"description":{"type":"string","description":"Description description"},"model_name":{"type":"string","description":"Model Name model_name","required":true},"flavor_name":{"type":"string","description":"Flavor Name flavor_name","required":true},"gpu_type":{"type":"string","description":"SupportedGPU gpu_type","required":true,"enum":["gpu-l40s-d","gpu-l40s-a","gpu-h100-sxm","gpu-h200-sxm","gpu-b200-sxm","gpu-b200-sxm-a","gpu-b300-sxm"]},"region":{"type":"string","description":"SupportedRegion region","required":true,"enum":["eu-north1","man-ik8s","us-central1","us-north1","eu-west1","eu-west2","me-west1","uk-south1","tf-eu1","tf-uk1","tf-us1","tf-us2","tf-us3","tf-us4","tf-ca1"]},"gpu_count":{"type":"integer","description":"Gpu Count gpu_count","required":true},"custom_weights_id":{"type":"string","description":"custom_weights_id"},"scaling":{"type":"object","description":"EndpointScaling scaling","required":true,"properties":{"min_replicas":{"type":"integer","description":"Min Replicas min_replicas","required":true},"max_replicas":{"type":"integer","description":"Max Replicas max_replicas","required":true}}},"reservation_policy":{"type":"object","description":"ReservationPolicy reservation_policy","properties":{"policy":{"type":"string","description":"ReservationPolicyType policy","required":true,"enum":["AUTO","FORBID","STRICT"]},"reservation_ids":{"type":"array","description":"Reservation Ids reservation_ids"}}}}},"example":{"name":"","description":"","model_name":"","flavor_name":"","gpu_type":"","region":"","gpu_count":"","custom_weights_id":"","scaling":{},"reservation_policy":{}}}}}}},"/v0/dedicated_endpoints/templates":{"get":{"tags":["Dedicated Endpoints"],"parameters":[{"name":"ai_project_id","in":"query","description":"Project ID to list templates","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v0/dedicated_endpoints/templates"},"summary":"List Dedicated Endpoint Templates","description":"List Dedicated Endpoint Templates","security":[{"bearerAuth":[]}]}},"/v0/dedicated_endpoints/{endpoint_id}":{"patch":{"tags":["Dedicated Endpoints"],"parameters":[{"name":"endpoint_id","in":"path","description":"endpoint_id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v0/dedicated_endpoints/{endpoint_id}"},"summary":"Update Dedicated Endpoint","description":"Update Dedicated Endpoint","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"name":{"type":"string","description":"name"},"description":{"type":"string","description":"description"},"enabled":{"type":"boolean","description":"enabled"},"gpu_type":{"type":"string","description":"SupportedGPU gpu_type","enum":["gpu-l40s-d","gpu-l40s-a","gpu-h100-sxm","gpu-h200-sxm","gpu-b200-sxm","gpu-b200-sxm-a","gpu-b300-sxm"]},"gpu_count":{"type":"integer","description":"gpu_count"},"custom_weights_id":{"type":"string","description":"custom_weights_id"},"scaling":{"type":"object","description":"EndpointScaling scaling","properties":{"min_replicas":{"type":"integer","description":"Min Replicas min_replicas","required":true},"max_replicas":{"type":"integer","description":"Max Replicas max_replicas","required":true}}}}},"example":{"name":"","description":"","enabled":"","gpu_type":"","gpu_count":"","custom_weights_id":"","scaling":{}}}}}},"delete":{"tags":["Dedicated Endpoints"],"parameters":[{"name":"endpoint_id","in":"path","description":"endpoint_id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v0/dedicated_endpoints/{endpoint_id}"},"summary":"Delete Dedicated Endpoint","description":"Delete Dedicated Endpoint","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1/chat/completions":{"post":{"tags":["Inference"],"parameters":[{"name":"ai_project_id","in":"query","description":"current project ID","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/inference/create-chat-completion","api_endpoint":"https://api.tokenfactory.nebius.com/v1/chat/completions"},"summary":"Create chat completion","description":"Create chat completion","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"model":{"type":"string","description":"ID of the model to use. model","required":true},"store":{"type":"boolean","description":"store"},"messages":{"type":"array","description":"A list of messages comprising the conversation so far. [Example Python code](https://cookbook.openai.com/examples/how_to_format_inputs_to_chatgpt_models). messages","required":true,"items":{"type":"object","properties":{"role":{"type":"string","description":"ChatMessageRole role","enum":["system","user","assistant","tool"]},"content":{"type":"string","description":"content"},"name":{"type":"string","description":"name"},"tool_calls":{"type":"array","description":"tool_calls"},"tool_call_id":{"type":"string","description":"tool_call_id"},"tools":{"type":"string","description":"Moonshot Kimi dynamic-tools extension; forwarded verbatim to the engine. tools"},"reasoning_content":{"type":"string","description":"reasoning_content"},"reasoning":{"type":"string","description":"reasoning"}}}},"max_tokens":{"type":"integer","description":"max_tokens"},"max_completion_tokens":{"type":"integer","description":"max_completion_tokens"},"temperature":{"type":"number","description":"temperature"},"top_p":{"type":"number","description":"top_p"},"tools":{"type":"array","description":"tools","items":{"type":"object","properties":{"type":{"type":"string","description":"The type of the tool. Currently, only `function` is supported. type"},"function":{"type":"object","description":"FunctionObject function"}}}},"tool_choice":{"type":"string","description":"tool_choice"},"reasoning_effort":{"type":"string","description":"reasoning_effort","enum":["none","minimal","low","medium","high","xhigh"]},"n":{"type":"integer","description":"n"},"stream":{"type":"boolean","description":"stream"},"stream_options":{"type":"object","description":"stream_options"},"stop":{"type":"array","description":"stop","items":{"type":"string"}},"presence_penalty":{"type":"number","description":"presence_penalty"},"frequency_penalty":{"type":"number","description":"frequency_penalty"},"logit_bias":{"type":"object","description":"logit_bias"},"logprobs":{"type":"boolean","description":"logprobs"},"top_logprobs":{"type":"integer","description":"top_logprobs"},"user":{"type":"string","description":"user"},"response_format":{"type":"object","description":"ResponseFormat response_format","properties":{"type":{"type":"string","description":"Type type","required":true,"enum":["text","json_object","json_schema"]},"json_schema":{"type":"object","description":"JsonSchemaResponseFormat json_schema"}}},"extra_body":{"type":"object","description":"extra_body"},"service_tier":{"type":"string","description":"Represents the service tier for requests.\n\nAttributes:\n    Auto: Automatically choose the best available tier for the request (Default or OverLimit).\n    Analyze response to determine which tier was used.\n    Default: Return 429 errors on hitting the rate limit, do not exceed to the OverLimit tier.\n    OverLimit: Indicate that the request was over the user limit.\n            This tier cannot be set by user in the request, but us used in a response for tier=Auto.\n    Flex: Do not consume rate-limit credits, but run with lower priority. May still result in 429 errors\n    in case of if there is no resources to process. service_tier","enum":["auto","default","over-limit","flex","no-limit"]}}},"example":{"model":"","store":"","messages":[],"max_tokens":"","max_completion_tokens":"","temperature":"","top_p":"","tools":[],"tool_choice":"","reasoning_effort":"","n":"","stream":"","stream_options":{},"stop":[],"presence_penalty":"","frequency_penalty":"","logit_bias":{},"logprobs":"","top_logprobs":"","user":"","response_format":{},"extra_body":{},"service_tier":""}}}}}},"/v1/completions":{"post":{"tags":["Inference"],"parameters":[{"name":"ai_project_id","in":"query","description":"current project ID","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/inference/create-completion","api_endpoint":"https://api.tokenfactory.nebius.com/v1/completions"},"summary":"Create completion","description":"Create completion","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"model":{"type":"string","description":"ID of the model to use. model","required":true},"prompt":{"type":"string","description":"prompt","required":true},"stream":{"type":"boolean","description":"stream"},"stream_options":{"type":"object","description":"stream_options"},"max_tokens":{"type":"integer","description":"max_tokens"},"temperature":{"type":"number","description":"temperature"},"top_p":{"type":"number","description":"top_p"},"n":{"type":"integer","description":"n"},"logprobs":{"type":"integer","description":"logprobs"},"echo":{"type":"boolean","description":"echo"},"stop":{"type":"string","description":"stop"},"presence_penalty":{"type":"number","description":"presence_penalty"},"frequency_penalty":{"type":"number","description":"frequency_penalty"},"logit_bias":{"type":"object","description":"logit_bias"},"user":{"type":"string","description":"user"},"extra_body":{"type":"object","description":"extra_body"},"service_tier":{"type":"string","description":"Represents the service tier for requests.\n\nAttributes:\n    Auto: Automatically choose the best available tier for the request (Default or OverLimit).\n    Analyze response to determine which tier was used.\n    Default: Return 429 errors on hitting the rate limit, do not exceed to the OverLimit tier.\n    OverLimit: Indicate that the request was over the user limit.\n            This tier cannot be set by user in the request, but us used in a response for tier=Auto.\n    Flex: Do not consume rate-limit credits, but run with lower priority. May still result in 429 errors\n    in case of if there is no resources to process. service_tier","enum":["auto","default","over-limit","flex","no-limit"]}}},"example":{"model":"","prompt":"","stream":"","stream_options":{},"max_tokens":"","temperature":"","top_p":"","n":"","logprobs":"","echo":"","stop":"","presence_penalty":"","frequency_penalty":"","logit_bias":{},"user":"","extra_body":{},"service_tier":""}}}}}},"/v1/datasets":{"get":{"tags":["Datasets"],"parameters":[{"name":"limit","in":"query","description":"limit","required":false,"schema":{"type":"integer","example":""}},{"name":"after","in":"query","description":"after","required":false,"schema":{"type":"string","example":""}},{"name":"ai_project_id","in":"query","description":"ai_project_id","required":false,"schema":{"type":"string","example":""}},{"name":"sort_by","in":"query","description":"sort_by","required":false,"schema":{"type":"string","example":"","items":{"type":"string","enum":["created_at","name"]}}},{"name":"sort_order","in":"query","description":"sort_order","required":false,"schema":{"type":"string","example":"","items":{"type":"string","enum":["asc","desc"]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v1/datasets"},"summary":"Get a list of datasets in project","description":"Get a list of datasets in project","security":[{"bearerAuth":[]}]},"post":{"tags":["Datasets"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v1/datasets"},"summary":"Create a dataset by uploading data","description":"Create a dataset by uploading data","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1/datasets/uploads":{"post":{"tags":["Datasets"],"parameters":[{"name":"ai_project_id","in":"query","description":"ai_project_id","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v1/datasets/uploads"},"summary":"Create a new multipart upload for a dataset","description":"Create a new multipart upload for a dataset","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":false,"content":{"multipart/form-data":{"schema":{"type":"object","required":[],"properties":{"name":{"type":"string","description":"ID of the dataset. name","required":true},"schema":{"type":"array","description":"Dataset schema definition. schema","required":true,"items":{"type":"object","properties":{"name":{"type":"string","description":"Name name"},"type":{"type":"object","description":"SchemaPrimitive type"}}}},"folder":{"type":"string","description":"Folder path where the dataset is stored. folder","required":true}}},"example":{"name":"","schema":[],"folder":""}}}}}},"/v1/datasets/uploads/{upload_id}":{"get":{"tags":["Datasets"],"parameters":[{"name":"upload_id","in":"path","description":"upload_id","required":true,"schema":{"type":"string","example":""}},{"name":"ai_project_id","in":"query","description":"ai_project_id","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v1/datasets/uploads/{upload_id}"},"summary":"Get information about a multipart upload","description":"Get information about a multipart upload","security":[{"bearerAuth":[]}]}},"/v1/datasets/uploads/{upload_id}/cancel":{"post":{"tags":["Datasets"],"parameters":[{"name":"upload_id","in":"path","description":"upload_id","required":true,"schema":{"type":"string","example":""}},{"name":"ai_project_id","in":"query","description":"ai_project_id","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v1/datasets/uploads/{upload_id}/cancel"},"summary":"Cancel a multipart upload","description":"Cancel a multipart upload","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":false,"content":{"multipart/form-data":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1/datasets/uploads/{upload_id}/complete":{"post":{"tags":["Datasets"],"parameters":[{"name":"upload_id","in":"path","description":"upload_id","required":true,"schema":{"type":"string","example":""}},{"name":"ai_project_id","in":"query","description":"ai_project_id","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v1/datasets/uploads/{upload_id}/complete"},"summary":"Complete a multipart upload, create a new dataset","description":"Complete a multipart upload, create a new dataset","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":false,"content":{"multipart/form-data":{"schema":{"type":"object","required":[],"properties":{"part_ids":{"type":"array","description":"Part Ids part_ids","required":true,"items":{"type":"string"}}}},"example":{"part_ids":[]}}}}}},"/v1/datasets/uploads/{upload_id}/parts":{"get":{"tags":["Datasets"],"parameters":[{"name":"upload_id","in":"path","description":"upload_id","required":true,"schema":{"type":"string","example":""}},{"name":"ai_project_id","in":"query","description":"ai_project_id","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v1/datasets/uploads/{upload_id}/parts"},"summary":"List parts of a multipart upload","description":"List parts of a multipart upload","security":[{"bearerAuth":[]}]},"post":{"tags":["Datasets"],"parameters":[{"name":"upload_id","in":"path","description":"upload_id","required":true,"schema":{"type":"string","example":""}},{"name":"ai_project_id","in":"query","description":"ai_project_id","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v1/datasets/uploads/{upload_id}/parts"},"summary":"Upload a new part for a multipart upload","description":"Upload a new part for a multipart upload","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":false,"content":{"multipart/form-data":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1/datasets/{dataset_id}":{"get":{"tags":["Datasets"],"parameters":[{"name":"dataset_id","in":"path","description":"dataset_id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v1/datasets/{dataset_id}"},"summary":"Get dataset info","description":"Get dataset info","security":[{"bearerAuth":[]}]},"patch":{"tags":["Datasets"],"parameters":[{"name":"dataset_id","in":"path","description":"dataset_id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v1/datasets/{dataset_id}"},"summary":"Patch dataset info","description":"Patch dataset info","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"name":{"type":"string","description":"name"},"folder":{"type":"string","description":"folder"}}},"example":{"name":"","folder":""}}}}},"delete":{"tags":["Datasets"],"parameters":[{"name":"dataset_id","in":"path","description":"dataset_id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v1/datasets/{dataset_id}"},"summary":"Delete a dataset","description":"Delete a dataset","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1/datasets/{dataset_id}/content":{"get":{"tags":["Datasets"],"parameters":[{"name":"dataset_id","in":"path","description":"dataset_id","required":true,"schema":{"type":"string","example":""}},{"name":"limit","in":"query","description":"limit","required":false,"schema":{"type":"integer","example":""}},{"name":"offset","in":"query","description":"offset","required":false,"schema":{"type":"integer","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v1/datasets/{dataset_id}/content"},"summary":"Read dataset content","description":"Read dataset content","security":[{"bearerAuth":[]}]}},"/v1/datasets/{dataset_id}/export":{"get":{"tags":["Datasets"],"parameters":[{"name":"dataset_id","in":"path","description":"dataset_id","required":true,"schema":{"type":"string","example":""}},{"name":"format","in":"query","description":"Export format: csv or jsonl","required":true,"schema":{"type":"string","example":""}},{"name":"columns","in":"query","description":"Comma-separated list of columns to export, optional","required":false,"schema":{"type":"string","example":""}},{"name":"limit","in":"query","description":"Limit the number of rows to export, optional","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v1/datasets/{dataset_id}/export"},"summary":"Read dataset content as csv or jsonl","description":"Read dataset content as csv or jsonl","security":[{"bearerAuth":[]}]}},"/v1/datasets/{dataset_id}/query_templates":{"get":{"tags":["Datasets"],"parameters":[{"name":"dataset_id","in":"path","description":"dataset_id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v1/datasets/{dataset_id}/query_templates"},"summary":"Get dataset query template","description":"Get dataset query template","security":[{"bearerAuth":[]}]}},"/v1/embeddings":{"post":{"tags":["Inference"],"parameters":[{"name":"ai_project_id","in":"query","description":"current project ID","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/inference/create-embeddings","api_endpoint":"https://api.tokenfactory.nebius.com/v1/embeddings"},"summary":"Create embeddings","description":"Create embeddings","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"model":{"type":"string","description":"ID of the model to use. model","required":true},"input":{"type":"string","description":"input","required":true},"encoding_format":{"type":"string","description":"encoding_format"},"user":{"type":"string","description":"user"},"service_tier":{"type":"string","description":"Represents the service tier for requests.\n\nAttributes:\n    Auto: Automatically choose the best available tier for the request (Default or OverLimit).\n    Analyze response to determine which tier was used.\n    Default: Return 429 errors on hitting the rate limit, do not exceed to the OverLimit tier.\n    OverLimit: Indicate that the request was over the user limit.\n            This tier cannot be set by user in the request, but us used in a response for tier=Auto.\n    Flex: Do not consume rate-limit credits, but run with lower priority. May still result in 429 errors\n    in case of if there is no resources to process. service_tier","enum":["auto","default","over-limit","flex","no-limit"]},"dimensions":{"type":"integer","description":"dimensions"}}},"example":{"model":"","input":"","encoding_format":"","user":"","service_tier":"","dimensions":""}}}}}},"/v1/files":{"get":{"tags":["Files"],"parameters":[{"name":"limit","in":"query","description":"limit","required":false,"schema":{"type":"integer","example":""}},{"name":"purpose","in":"query","description":"purpose","required":false,"schema":{"type":"string","example":""}},{"name":"ai_project_id","in":"query","description":"Project ID to list files for","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v1/files"},"summary":"List user files","description":"List user files","security":[{"bearerAuth":[]}]},"post":{"tags":["Files"],"parameters":[{"name":"ai_project_id","in":"query","description":"Project ID to upload file to","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v1/files"},"summary":"Upload file","description":"Upload file","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"file":{"type":"string","description":"File file","required":true},"purpose":{"type":"string","description":"FilePurpose purpose","required":true,"enum":["batch","fine-tune","history"]}}},"example":{"file":"","purpose":""}}}}}},"/v1/files/{file_id}":{"get":{"tags":["Files"],"parameters":[{"name":"file_id","in":"path","description":"file_id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v1/files/{file_id}"},"summary":"Retrieve file","description":"Retrieve file","security":[{"bearerAuth":[]}]},"delete":{"tags":["Files"],"parameters":[{"name":"file_id","in":"path","description":"file_id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v1/files/{file_id}"},"summary":"Delete file","description":"Delete file","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1/files/{file_id}/content":{"get":{"tags":["Files"],"parameters":[{"name":"file_id","in":"path","description":"file_id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v1/files/{file_id}/content"},"summary":"Retrieve file content","description":"Retrieve file content","security":[{"bearerAuth":[]}]}},"/v1/files/{file_id}/link":{"get":{"tags":["Files"],"parameters":[{"name":"file_id","in":"path","description":"file_id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v1/files/{file_id}/link"},"summary":"Returns URL with link to download file content","description":"Returns URL with link to download file content","security":[{"bearerAuth":[]}]}},"/v1/fine_tuning/jobs":{"get":{"tags":["Fine-Tuning"],"parameters":[{"name":"limit","in":"query","description":"limit","required":false,"schema":{"type":"string","example":""}},{"name":"after","in":"query","description":"after","required":false,"schema":{"type":"string","example":""}},{"name":"ai_project_id","in":"query","description":"Project ID to list fine tuning jobs","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v1/fine_tuning/jobs"},"summary":"List fine-tuning jobs","description":"List fine-tuning jobs","security":[{"bearerAuth":[]}]},"post":{"tags":["Fine-Tuning"],"parameters":[{"name":"ai_project_id","in":"query","description":"Project ID to list fine tuning jobs","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v1/fine_tuning/jobs"},"summary":"Create a fine-tuning job","description":"Create a fine-tuning job","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"model":{"type":"string","description":"The name of the model to fine-tune model","required":true},"from_checkpoint":{"type":"object","description":"HFCheckpointParametersRequest from_checkpoint","properties":{"type":{"type":"string","description":"type"},"repo":{"type":"string","description":"Repo repo","required":true},"revision":{"type":"string","description":"revision"},"token":{"type":"string","description":"token"}}},"training_file":{"type":"string","description":"The ID of the uploaded training data file training_file","required":true},"validation_file":{"type":"string","description":"validation_file"},"hyperparameters":{"type":"object","description":"SupervisedHParameters hyperparameters","properties":{"batch_size":{"type":"integer","description":"Batch size for training batch_size"},"learning_rate":{"type":"number","description":"Learning rate for training learning_rate"},"n_epochs":{"type":"integer","description":"Number of epochs for training n_epochs"},"warmup_ratio":{"type":"number","description":"Warmup ratio for learning rate warmup_ratio"},"weight_decay":{"type":"number","description":"Weight decay for optimizer weight_decay"},"packing":{"type":"boolean","description":"Whether to use packing for training packing"},"max_grad_norm":{"type":"number","description":"Maximum gradient norm for optimizer max_grad_norm"},"context_length":{"type":"integer","description":"Context length for training context_length"},"lora":{"type":"boolean","description":"Whether to use LoRA (Low-Rank Adaptation) for training lora"},"lora_r":{"type":"integer","description":"Rank for LoRA lora_r"},"lora_alpha":{"type":"integer","description":"Alpha parameter for LoRA lora_alpha"},"lora_dropout":{"type":"number","description":"Dropout rate for LoRA lora_dropout"}}},"method":{"type":"object","description":"SupervisedMethodConfig method","properties":{"type":{"type":"string","description":"Type type"},"supervised":{"type":"object","description":"SupervisedConfig supervised","required":true}}},"integrations":{"type":"array","description":"integrations","items":{"type":"object","properties":{}}},"seed":{"type":"integer","description":"seed"},"suffix":{"type":"string","description":"suffix"},"tags":{"type":"array","description":"tags","items":{"type":"string"}},"extra_body":{"type":"object","description":"extra_body"}}},"example":{"model":"","from_checkpoint":{},"training_file":"","validation_file":"","hyperparameters":{},"method":{},"integrations":[],"seed":"","suffix":"","tags":[],"extra_body":{}}}}}}},"/v1/fine_tuning/jobs/{job_id}":{"get":{"tags":["Fine-Tuning"],"parameters":[{"name":"job_id","in":"path","description":"job_id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v1/fine_tuning/jobs/{job_id}"},"summary":"Get fine-tuning job info","description":"Get fine-tuning job info","security":[{"bearerAuth":[]}]}},"/v1/fine_tuning/jobs/{job_id}/cancel":{"post":{"tags":["Fine-Tuning"],"parameters":[{"name":"job_id","in":"path","description":"job_id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v1/fine_tuning/jobs/{job_id}/cancel"},"summary":"Cancel fine-tuning job","description":"Cancel fine-tuning job","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1/fine_tuning/jobs/{job_id}/checkpoints":{"get":{"tags":["Fine-Tuning"],"parameters":[{"name":"job_id","in":"path","description":"job_id","required":true,"schema":{"type":"string","example":""}},{"name":"limit","in":"query","description":"limit","required":false,"schema":{"type":"string","example":""}},{"name":"after","in":"query","description":"after","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v1/fine_tuning/jobs/{job_id}/checkpoints"},"summary":"List fine-tuning checkpoints","description":"List fine-tuning checkpoints","security":[{"bearerAuth":[]}]}},"/v1/fine_tuning/jobs/{job_id}/checkpoints/{checkpoint_id}":{"get":{"tags":["Fine-Tuning"],"parameters":[{"name":"job_id","in":"path","description":"job_id","required":true,"schema":{"type":"string","example":""}},{"name":"checkpoint_id","in":"path","description":"checkpoint_id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v1/fine_tuning/jobs/{job_id}/checkpoints/{checkpoint_id}"},"summary":"Get fine-tuning checkpoint","description":"Get fine-tuning checkpoint","security":[{"bearerAuth":[]}]}},"/v1/fine_tuning/jobs/{job_id}/events":{"get":{"tags":["Fine-Tuning"],"parameters":[{"name":"job_id","in":"path","description":"job_id","required":true,"schema":{"type":"string","example":""}},{"name":"limit","in":"query","description":"limit","required":false,"schema":{"type":"string","example":""}},{"name":"after","in":"query","description":"after","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v1/fine_tuning/jobs/{job_id}/events"},"summary":"List fine-tuning events","description":"List fine-tuning events","security":[{"bearerAuth":[]}]}},"/v1/fine_tuning/models/spec-draft":{"get":{"tags":["Fine-Tuning"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v1/fine_tuning/models/spec-draft"},"summary":"List spec-draft trainable models","description":"List spec-draft trainable models","security":[{"bearerAuth":[]}]}},"/v1/images/generations":{"post":{"tags":["Inference"],"parameters":[{"name":"ai_project_id","in":"query","description":"current project ID","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/examples/image-generation","api_endpoint":"https://api.tokenfactory.nebius.com/v1/images/generations"},"summary":"Generate","description":"Generate","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"model":{"type":"string","description":"ID of the model to use. model","required":true},"loras":{"type":"array","description":"loras","items":{"type":"object","properties":{"url":{"type":"string","description":"LoRA .safetensors URL url"},"scale":{"type":"number","description":"Scale of LoRA weights scale"}}}},"prompt":{"type":"string","description":"A text description of the desired image(s). prompt","required":true},"width":{"type":"integer","description":"The width of the generated image(s) in pixels. width"},"height":{"type":"integer","description":"The height of the generated image(s) in pixels. height"},"num_inference_steps":{"type":"integer","description":"num_inference_steps"},"seed":{"type":"integer","description":"Random seed for image generation. Use -1 for a random seed. seed"},"guidance_scale":{"type":"number","description":"guidance_scale"},"negative_prompt":{"type":"string","description":"A text description of the non-desired image(s). negative_prompt"},"response_extension":{"type":"string","description":"ResponseExtension response_extension","enum":["webp","jpg","png"]},"response_format":{"type":"string","description":"ResponseFormat response_format","enum":["b64_json","url"]}}},"example":{"model":"","loras":[],"prompt":"","width":"","height":"","num_inference_steps":"","seed":"","guidance_scale":"","negative_prompt":"","response_extension":"","response_format":""}}}}}},"/v1/models":{"get":{"tags":["Models"],"parameters":[{"name":"ai_project_id","in":"query","description":"Project ID to list models from.","required":false,"schema":{"type":"string","example":""}},{"name":"verbose","in":"query","description":"verbose","required":false,"schema":{"type":"boolean","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/models/list-models","api_endpoint":"https://api.tokenfactory.nebius.com/v1/models"},"summary":"List models","description":"List models","security":[{"bearerAuth":[]}]}},"/v1/operations":{"get":{"tags":["Datasets"],"parameters":[{"name":"limit","in":"query","description":"limit","required":false,"schema":{"type":"integer","example":""}},{"name":"cursor_time","in":"query","description":"ISO 8601 timestamp used as the pagination cursor","required":false,"schema":{"type":"string","example":""}},{"name":"ai_project_id","in":"query","description":"ai_project_id","required":false,"schema":{"type":"string","example":""}},{"name":"type","in":"query","description":"type","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v1/operations"},"summary":"Filter operations by attributes","description":"Filter operations by attributes","security":[{"bearerAuth":[]}]},"post":{"tags":["Datasets"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v1/operations"},"summary":"Run operation","description":"Run operation","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1/operations/{operation_id}":{"get":{"tags":["Datasets"],"parameters":[{"name":"operation_id","in":"path","description":"operation_id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v1/operations/{operation_id}"},"summary":"Get operation info by id","description":"Get operation info by id","security":[{"bearerAuth":[]}]}},"/v1/operations/{operation_id}/cancel":{"post":{"tags":["Datasets"],"parameters":[{"name":"operation_id","in":"path","description":"operation_id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v1/operations/{operation_id}/cancel"},"summary":"Stop operation by id","description":"Stop operation by id","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1/operations/{operation_id}/errors":{"get":{"tags":["Datasets"],"parameters":[{"name":"operation_id","in":"path","description":"operation_id","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v1/operations/{operation_id}/errors"},"summary":"Get operation errors","description":"Get operation errors","security":[{"bearerAuth":[]}]}},"/v1/operations/{operation_id}/results":{"get":{"tags":["Datasets"],"parameters":[{"name":"operation_id","in":"path","description":"operation_id","required":true,"schema":{"type":"string","example":""}},{"name":"limit","in":"query","description":"limit","required":false,"schema":{"type":"string","example":""}},{"name":"after","in":"query","description":"after","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/introduction","api_endpoint":"https://api.tokenfactory.nebius.com/v1/operations/{operation_id}/results"},"summary":"Get operation results","description":"Get operation results","security":[{"bearerAuth":[]}]}},"/v1/rerank":{"post":{"tags":["Inference"],"parameters":[{"name":"ai_project_id","in":"query","description":"current project ID","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/inference/rerank-documents","api_endpoint":"https://api.tokenfactory.nebius.com/v1/rerank"},"summary":"Rerank documents","description":"Rerank documents","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"model":{"type":"string","description":"ID of the model to use. model","required":true},"query":{"type":"string","description":"Query to rerank, encoded as a string. query","required":true},"documents":{"type":"array","description":"Documents to rerank, encoded as a list of strings. documents","required":true,"items":{"type":"string"}},"user":{"type":"string","description":"user"},"service_tier":{"type":"string","description":"Represents the service tier for requests.\n\nAttributes:\n    Auto: Automatically choose the best available tier for the request (Default or OverLimit).\n    Analyze response to determine which tier was used.\n    Default: Return 429 errors on hitting the rate limit, do not exceed to the OverLimit tier.\n    OverLimit: Indicate that the request was over the user limit.\n            This tier cannot be set by user in the request, but us used in a response for tier=Auto.\n    Flex: Do not consume rate-limit credits, but run with lower priority. May still result in 429 errors\n    in case of if there is no resources to process. service_tier","enum":["auto","default","over-limit","flex","no-limit"]}}},"example":{"model":"","query":"","documents":[],"user":"","service_tier":""}}}}}},"/v1/responses":{"post":{"tags":["Inference"],"parameters":[{"name":"ai_project_id","in":"query","description":"current project ID","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.tokenfactory.nebius.com/api-reference/inference/create-a-response","api_endpoint":"https://api.tokenfactory.nebius.com/v1/responses"},"summary":"Create a response","description":"Create a response","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"background":{"type":"boolean","description":"background"},"include":{"type":"array","description":"include","items":{"type":"string"}},"input":{"type":"string","description":"input","required":true},"instructions":{"type":"string","description":"instructions"},"max_output_tokens":{"type":"integer","description":"max_output_tokens"},"max_tool_calls":{"type":"integer","description":"max_tool_calls"},"metadata":{"type":"object","description":"metadata"},"model":{"type":"string","description":"The model used for the chat completion. model","required":true},"parallel_tool_calls":{"type":"boolean","description":"parallel_tool_calls"},"previous_response_id":{"type":"string","description":"previous_response_id"},"prompt":{"type":"object","description":"Reference to a prompt template and its variables.\n[Learn more](https://platform.openai.com/docs/guides/text?api-mode=responses#reusable-prompts). prompt","properties":{"id":{"type":"string","description":"Id id","required":true},"variables":{"type":"object","description":"variables"},"version":{"type":"string","description":"version"}}},"reasoning":{"type":"object","description":"**gpt-5 and o-series models only**\n\nConfiguration options for\n[reasoning models](https://platform.openai.com/docs/guides/reasoning). reasoning","properties":{"effort":{"type":"string","description":"effort","enum":["none","minimal","low","medium","high","xhigh"]},"generate_summary":{"type":"string","description":"generate_summary","enum":["auto","concise","detailed"]},"summary":{"type":"string","description":"summary","enum":["auto","concise","detailed"]}}},"service_tier":{"type":"string","description":"Represents the service tier for requests.\n\nAttributes:\n    Auto: Automatically choose the best available tier for the request (Default or OverLimit).\n    Analyze response to determine which tier was used.\n    Default: Return 429 errors on hitting the rate limit, do not exceed to the OverLimit tier.\n    OverLimit: Indicate that the request was over the user limit.\n            This tier cannot be set by user in the request, but us used in a response for tier=Auto.\n    Flex: Do not consume rate-limit credits, but run with lower priority. May still result in 429 errors\n    in case of if there is no resources to process. service_tier","enum":["auto","default","over-limit","flex","no-limit"]},"store":{"type":"boolean","description":"store"},"stream":{"type":"boolean","description":"stream"},"temperature":{"type":"number","description":"temperature"},"text":{"type":"object","description":"Configuration options for a text response from the model.\n\nCan be plain\ntext or structured JSON data. Learn more:\n- [Text inputs and outputs](https://platform.openai.com/docs/guides/text)\n- [Structured Outputs](https://platform.openai.com/docs/guides/structured-outputs) text","properties":{"format":{"type":"object","description":"Default response format. Used to generate text responses. format"},"verbosity":{"type":"string","description":"verbosity","enum":["low","medium","high"]}}},"tool_choice":{"type":"string","description":"tool_choice","enum":["none","auto","required"]},"tools":{"type":"array","description":"An array of tools the model may call while generating a response. tools","items":{"type":"object","properties":{}}},"top_logprobs":{"type":"integer","description":"top_logprobs"},"top_p":{"type":"number","description":"top_p"},"truncation":{"type":"string","description":"The truncation strategy to use for the model response. truncation","enum":["auto","disabled"]},"user":{"type":"string","description":"user"},"prompt_cache_key":{"type":"string","description":"prompt_cache_key"}}},"example":{"background":"","include":[],"input":"","instructions":"","max_output_tokens":"","max_tool_calls":"","metadata":{},"model":"","parallel_tool_calls":"","previous_response_id":"","prompt":{},"reasoning":{},"service_tier":"","store":"","stream":"","temperature":"","text":{},"tool_choice":"","tools":[],"top_logprobs":"","top_p":"","truncation":"","user":"","prompt_cache_key":""}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"security":[{"bearerAuth":[]}]}