{"openapi":"3.1.0","info":{"title":"Nebius Token Factory (BYOK) API","version":"0.1.0","description":"Nebius Token Factory (BYOK) lets an AI assistant read your own Nebius Token Factory data through the Nebius Token Factory API with a key you supply (Nebius Token Factory API key). Read-only: 8 tools (list_models, list_files, get_file, list_fine_tuning_jobs, get_fine_tuning_job, list_fine_tuning_events, list_fine_tuning_checkpoints, get_fine_tuning_checkpoint). The BYOK key travels with each...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-nebius-tokenfactory.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-nebius-tokenfactory/docs"},"termsOfService":"https://connectorbay.com/byok-nebius-tokenfactory/terms"},"servers":[{"url":"https://byok-nebius-tokenfactory.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-nebius-tokenfactory/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/list_models":{"post":{"operationId":"list_models","summary":"List the models available to the key. With verbose true each entry also has name, context length, pricing, architecture ","description":"List the models available to the key. With verbose true each entry also has name, context length, pricing, architecture and status; otherwise only id, creation time and owner. Use for \"Which models can I use on Nebius Token Factory and what do they cost\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"ai_project_id":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only items of this Token Factory project id; omit for the key's default project.","title":"Ai Project Id"},"verbose":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True for the detailed model records.","title":"Verbose"}},"title":"list_modelsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_files":{"post":{"operationId":"list_files","summary":"List uploaded files (names, sizes, purposes) for batch, fine-tune or history use. File contents are not returned. Use fo","description":"List uploaded files (names, sizes, purposes) for batch, fine-tune or history use. File contents are not returned. Use for \"Which files have I uploaded to Nebius Token Factory\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"Maximum number of files to return (default 10).","title":"Limit"},"purpose":{"anyOf":[{"enum":["batch","fine-tune","history"],"type":"string"},{"type":"null"}],"default":null,"description":"Only files with this purpose.","title":"Purpose"},"ai_project_id":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only items of this Token Factory project id; omit for the key's default project.","title":"Ai Project Id"}},"title":"list_filesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_file":{"post":{"operationId":"get_file","summary":"Get metadata of one uploaded file: name, size, purpose, upload time and status. Content is not returned. Use for \"What i","description":"Get metadata of one uploaded file: name, size, purpose, upload time and status. Content is not returned. Use for \"What is the status of Nebius file file-abc123\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"file_id":{"description":"File id from list_files.","maxLength":200,"title":"File Id","type":"string"}},"required":["file_id"],"title":"get_fileArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_fine_tuning_jobs":{"post":{"operationId":"list_fine_tuning_jobs","summary":"List fine-tuning jobs with base model, status, timestamps (Unix seconds), token and step progress and training file. Pag","description":"List fine-tuning jobs with base model, status, timestamps (Unix seconds), token and step progress and training file. Page with after. Use for \"Which fine-tuning jobs have I run on Nebius Token Factory\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Maximum number of items to return.","title":"Limit"},"after":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Id of the last item of the previous page, to continue after it.","title":"After"},"ai_project_id":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only items of this Token Factory project id; omit for the key's default project.","title":"Ai Project Id"}},"title":"list_fine_tuning_jobsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_fine_tuning_job":{"post":{"operationId":"get_fine_tuning_job","summary":"Get one fine-tuning job: base model, status, progress, files, error and hyperparameters such as epochs, learning rate an","description":"Get one fine-tuning job: base model, status, progress, files, error and hyperparameters such as epochs, learning rate and LoRA settings. Use for \"How is my Nebius fine-tuning job ftjob-abc123 doing\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"job_id":{"description":"Fine-tuning job id from list_fine_tuning_jobs.","maxLength":200,"title":"Job Id","type":"string"}},"required":["job_id"],"title":"get_fine_tuning_jobArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_fine_tuning_events":{"post":{"operationId":"list_fine_tuning_events","summary":"List status events and log messages of a fine-tuning job with level, time and text. Page with after. Use for \"Show the l","description":"List status events and log messages of a fine-tuning job with level, time and text. Page with after. Use for \"Show the log events of Nebius fine-tuning job ftjob-abc123\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"job_id":{"description":"Fine-tuning job id from list_fine_tuning_jobs.","maxLength":200,"title":"Job Id","type":"string"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Maximum number of items to return.","title":"Limit"},"after":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Id of the last item of the previous page, to continue after it.","title":"After"}},"required":["job_id"],"title":"list_fine_tuning_eventsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_fine_tuning_checkpoints":{"post":{"operationId":"list_fine_tuning_checkpoints","summary":"List training checkpoints of a fine-tuning job with step number and loss and accuracy metrics. Page with after. Use for ","description":"List training checkpoints of a fine-tuning job with step number and loss and accuracy metrics. Page with after. Use for \"What checkpoints did Nebius fine-tuning job ftjob-abc123 produce\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"job_id":{"description":"Fine-tuning job id from list_fine_tuning_jobs.","maxLength":200,"title":"Job Id","type":"string"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Maximum number of items to return.","title":"Limit"},"after":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Id of the last item of the previous page, to continue after it.","title":"After"}},"required":["job_id"],"title":"list_fine_tuning_checkpointsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_fine_tuning_checkpoint":{"post":{"operationId":"get_fine_tuning_checkpoint","summary":"Get one checkpoint of a fine-tuning job: checkpoint model name, step number and training and validation metrics. Use for","description":"Get one checkpoint of a fine-tuning job: checkpoint model name, step number and training and validation metrics. Use for \"What were the validation loss and accuracy of checkpoint ckpt-1 of Nebius job ftjob-abc123\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"job_id":{"description":"Fine-tuning job id from list_fine_tuning_jobs.","maxLength":200,"title":"Job Id","type":"string"},"checkpoint_id":{"description":"Checkpoint id from list_fine_tuning_checkpoints.","maxLength":200,"title":"Checkpoint Id","type":"string"}},"required":["job_id","checkpoint_id"],"title":"get_fine_tuning_checkpointArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}