API reference
Foundry
Inference: models, chat completions, embeddings, keys, billing profile and request logs.
- Operations
- 58
- Base path
https://os.one.ml/api/v1/foundry- Scopes
adminfoundry:gateway:invokeiam:readiam:write- API keys
- 8 failed with an API key · 2 need a signed-in session · 37 refused to API keys · 11 tested with an API key
- SDK
genesis.call('foundry_createAudioSpeech', …)· helpers undergenesis.foundry- MCP
- Not in the MCP server
Operations
| Operation | Endpoint | API key |
|---|---|---|
| Validate a speech generation request | POST/audio/speech | API keys refused |
| Validate an audio transcription request | POST/audio/transcriptions | API keys refused |
| Create the server-configured TEST credit checkout | POST/billing/checkout/credits | Signed-in session |
| Read the current organization’s paid-credit balance | GET/billing/credits/balance | API keys refused |
| Read the current organization’s native Sandbox billing profile | GET/billing/profile | API keys refused |
| Ensure the current organization’s TEST billing profile | POST/billing/profile/ensure | Signed-in session |
| Create a chat completion | POST/chat/completions | API keys refused |
| Create embeddings | POST/embeddings | API keys refused |
| List tenant files | GET/files | API keys refused |
| Upload a tenant file | POST/files | API keys refused |
| Get file metadata | GET/files/{file_id} | API keys refused |
| Delete a tenant file | DELETE/files/{file_id} | API keys refused |
| Download tenant file content | GET/files/{file_id}/content | API keys refused |
| List tenant fine-tuning jobs | GET/fine_tuning/jobs | API keys refused |
| Create an admitted fine-tuning job | POST/fine_tuning/jobs | API keys refused |
| Get and refresh a fine-tuning job | GET/fine_tuning/jobs/{job_id} | API keys refused |
| Delete a terminal provider fine-tuning job | DELETE/fine_tuning/jobs/{job_id} | API keys refused |
| Cancel a provider fine-tuning job when contract-backed | POST/fine_tuning/jobs/{job_id}/cancel | API keys refused |
| List provider fine-tuning checkpoints when contract-backed | GET/fine_tuning/jobs/{job_id}/checkpoints | API keys refused |
| List normalized fine-tuning events | GET/fine_tuning/jobs/{job_id}/events | API keys refused |
| List tenant private fine-tuned models | GET/fine_tuning/models | API keys refused |
| Get a tenant private fine-tuned model | GET/fine_tuning/models/{model_id} | API keys refused |
| List contract-backed fine-tuning provider operations and executable lanes | GET/fine_tuning/providers | API keys refused |
| Get a generation receipt | GET/generations/{receipt_id} | API keys refused |
| Get a generation receipt by request ID | GET/generations/by-request/{request_id} | API keys refused |
| Validate an image generation request | POST/images | API keys refused |
| List image-capable models | GET/images/models | API keys refused |
| List tenant API keys | GET/keys | API keys refused |
| Create a tenant API key | POST/keys | Failed with an API key |
| Delete a tenant API key | DELETE/keys/{key_id} | Failed with an API key |
| List executable models | GET/models | Tested with an API key |
| List tenant provider credential policies | GET/provider-credential-policies | API keys refused |
| Set a tenant provider credential policy | PUT/provider-credential-policies/{provider_id} | API keys refused |
| List tenant BYOK provider keys | GET/provider-keys | API keys refused |
| Register a tenant BYOK provider key | POST/provider-keys | API keys refused |
| Delete a tenant provider key | DELETE/provider-keys/{provider_id} | API keys refused |
| Enable or disable a tenant provider key | PATCH/provider-keys/{provider_id} | API keys refused |
| Get the current receipt verification key | GET/receipts/verification-keys/current | Tested with an API key |
| Compare registry model dossiers | GET/registry/compare | Failed with an API key |
| List registry facets | GET/registry/facets | Tested with an API key |
| List registry labs | GET/registry/labs | Tested with an API key |
| Get a registry lab dossier | GET/registry/labs/{lab_id} | Tested with an API key |
| Get current model-base metadata | GET/registry/model-base/current | Tested with an API key |
| List model-base releases | GET/registry/model-base/releases | Tested with an API key |
| List registry models | GET/registry/models | Tested with an API key |
| Get a registry model | GET/registry/models/{canonical_model_id} | Failed with an API key |
| Get a model dossier | GET/registry/models/{canonical_model_id}/dossier | Failed with an API key |
| List model access offers | GET/registry/models/{canonical_model_id}/offers | Failed with an API key |
| List registry provenance | GET/registry/provenance | Failed with an API key |
| List registry providers | GET/registry/providers | Tested with an API key |
| Get a registry provider | GET/registry/providers/{provider_id} | Tested with an API key |
| Get a provider dossier | GET/registry/providers/{provider_id}/dossier | Tested with an API key |
| List registry sources | GET/registry/sources | Failed with an API key |
| Validate a rerank request | POST/rerank | API keys refused |
| Create an OpenAI Responses response | POST/responses | API keys refused |
| Validate a video generation request | POST/videos | API keys refused |
| Validate a video job lookup | GET/videos/{id} | API keys refused |
| Validate a video content lookup | GET/videos/{id}/content | API keys refused |
Audio
Validate a speech generation request
POST/v1/foundry/audio/speech
Request body application/json
modelstringrequiredpromptstringproviderobjectprovider.orderstring[]provider.onlystring[]provider.ignorestring[]provider.allow_fallbacksbooleanprovider.require_parametersbooleanprovider.zdrbooleanprovider.data_collection"allow" | "deny"provider.sortanyprovider.max_priceobject
Responses
- 501The request is validated, but this modality transport is not executable.
- 4xx 5xxThe error envelope.
curl -X POST "https://os.one.ml/api/v1/foundry/audio/speech" \
-H "Authorization: Bearer $GENESIS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "string"
}'import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_createAudioSpeech', {
body: {
model: 'string',
},
})Validate an audio transcription request
POST/v1/foundry/audio/transcriptions
Request body application/json
modelstringrequiredpromptstringproviderobjectprovider.orderstring[]provider.onlystring[]provider.ignorestring[]provider.allow_fallbacksbooleanprovider.require_parametersbooleanprovider.zdrbooleanprovider.data_collection"allow" | "deny"provider.sortanyprovider.max_priceobject
Responses
- 501The request is validated, but this modality transport is not executable.
- 4xx 5xxThe error envelope.
curl -X POST "https://os.one.ml/api/v1/foundry/audio/transcriptions" \
-H "Authorization: Bearer $GENESIS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "string"
}'import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_createAudioTranscription', {
body: {
model: 'string',
},
})Billing
Create the server-configured TEST credit checkout
POST/v1/foundry/billing/checkout/credits
Original Console human only. The verified organization and Sandbox context are resolved server-side. Preserve the same operation key after an unknown POST; reconcile before retrying.
Parameters
Idempotency-Keyheader · stringrequiredPersisted per-operation key; never create a replacement for an unknown result.
Request body application/json
A JSON object; see the description above.
Responses
- 200Native billing response
Response fields
intent_idstringrequiredstripe_checkout_session_idstringrequiredcheckout_urlstring (uri)status"paid" | "processing"stripe_payment_intent_idstring
- 4xx 5xxThe error envelope.
curl -X POST "https://os.one.ml/api/v1/foundry/billing/checkout/credits" \
-H "Authorization: Bearer $GENESIS_API_KEY" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-H "Content-Type: application/json" \
-d '{}'import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const idempotencyKey = '<a stable key per change>'
const result = await genesis.call('foundry_createNativeCreditCheckout', {
body: {},
}, {
headers: { 'Idempotency-Key': idempotencyKey }, // one key per change, reused on every retry
})Read the current organization’s paid-credit balance
GET/v1/foundry/billing/credits/balance
Original Console human only. The verified organization and Sandbox context are resolved server-side. Preserve the same operation key after an unknown POST; reconcile before retrying.
Responses
- 200Native billing response
Response fields
foundry_account_idstringrequiredavailable_microdollarsintegerrequiredmin 0 · max 9007199254740991
granted_microdollarsintegerrequiredmin 0 · max 9007199254740991
reserved_microdollarsintegerrequiredmin 0 · max 9007199254740991
reserved_overage_microdollarsintegerrequiredmin 0 · max 9007199254740991
settlement_owner"foundry"requiredlaunch_listedbooleanrequiredLegacy disposable-sandbox metadata; false does not deny a native customer.
- 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/billing/credits/balance" \
-H "Authorization: Bearer $GENESIS_API_KEY"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_readNativeCreditBalance')Read the current organization’s native Sandbox billing profile
GET/v1/foundry/billing/profile
Read-only original Console human delegation. Returns the actual profile and fresh canEnsure decision; it creates no customer or payment.
Responses
- 200Current organization billing profile
Response fields
schemaVersion1requiredstatus"ready" | "pending" | "attention_required"requiredorganizationIdstringrequiredbillingAccountIdstringrequiredenvironmentId"sandbox"requiredstripeAccountIdstringrequiredstripeCustomerIdstring | nullrequiredlivemodefalserequiredcanEnsurebooleanrequired
- 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/billing/profile" \
-H "Authorization: Bearer $GENESIS_API_KEY"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_readBillingProfile')Ensure the current organization’s TEST billing profile
POST/v1/foundry/billing/profile/ensure
Original Console human only. The verified organization and Sandbox context are resolved server-side. Preserve the same operation key after an unknown POST; reconcile before retrying.
Parameters
Idempotency-Keyheader · stringrequiredPersisted per-operation key; never create a replacement for an unknown result.
Request body application/json
A JSON object; see the description above.
Responses
- 200Native billing response
Response fields
schemaVersion1requiredstatus"ready" | "pending" | "attention_required"requiredorganizationIdstringrequiredbillingAccountIdstringrequiredenvironmentId"sandbox"requiredstripeAccountIdstringrequiredstripeCustomerIdstring | nullrequiredlivemodefalserequiredcanEnsurebooleanrequired
- 4xx 5xxThe error envelope.
curl -X POST "https://os.one.ml/api/v1/foundry/billing/profile/ensure" \
-H "Authorization: Bearer $GENESIS_API_KEY" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-H "Content-Type: application/json" \
-d '{}'import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const idempotencyKey = '<a stable key per change>'
const result = await genesis.call('foundry_ensureBillingProfile', {
body: {},
}, {
headers: { 'Idempotency-Key': idempotencyKey }, // one key per change, reused on every retry
})Chat
Create a chat completion
POST/v1/foundry/chat/completions
Request body application/json
modelstringmodelsstring[]messagesobject[]requiredmessages[].[].rolestringrequiredmessages[].[].contentanyrequiredstreambooleanproviderobjectprovider.orderstring[]provider.onlystring[]provider.ignorestring[]provider.allow_fallbacksbooleanprovider.require_parametersbooleanprovider.zdrbooleanprovider.data_collection"allow" | "deny"provider.sortanyprovider.max_priceobject
Responses
- 200Successful response.
Response fields
idstringrequiredmodelstringchoicesobject[]requiredusageobjectusage.prompt_tokensintegermin 0
usage.completion_tokensintegermin 0
usage.total_tokensintegermin 0
usage.costnumbermin 0
foundryobjectfoundry.request_idstringfoundry.receipt_idstringfoundry.billing_lane"pay_as_you_go" | "subscription_entitled" | "byok"
- 4xx 5xxThe error envelope.
curl -X POST "https://os.one.ml/api/v1/foundry/chat/completions" \
-H "Authorization: Bearer $GENESIS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"messages": []
}'import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_createChatCompletion', {
body: {
messages: [],
},
})Embeddings
Create embeddings
POST/v1/foundry/embeddings
Request body application/json
modelstringrequiredinputanyrequireddimensionsintegermin 1
Responses
- 200Successful response.
Response fields
objectstringmodelstringdataobject[]requiredusageobjectusage.prompt_tokensintegermin 0
usage.completion_tokensintegermin 0
usage.total_tokensintegermin 0
usage.costnumbermin 0
- 4xx 5xxThe error envelope.
curl -X POST "https://os.one.ml/api/v1/foundry/embeddings" \
-H "Authorization: Bearer $GENESIS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "string",
"input": "string"
}'import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_createEmbedding', {
body: {
model: 'string',
input: 'string',
},
})Files
List tenant files
GET/v1/foundry/files
Responses
- 200Successful response.
Response fields
dataobject[]requireddata[].[].idstringrequireddata[].[].type"file"requireddata[].[].filenamestringrequireddata[].[].mime_typestringrequireddata[].[].size_bytesintegerrequiredmin 0
data[].[].downloadablebooleanrequireddata[].[].created_atanyrequiredhas_morebooleancursorstring | null
- 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/files" \
-H "Authorization: Bearer $GENESIS_API_KEY"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_listFiles')Upload a tenant file
POST/v1/foundry/files
Request bodies sent through https://os.one.ml/api are limited to 2 MiB.
Request body multipart/form-data
filestring (binary)required
Responses
- 200Successful response.
Response fields
idstringrequiredtype"file"requiredfilenamestringrequiredmime_typestringrequiredsize_bytesintegerrequiredmin 0
downloadablebooleanrequiredcreated_atanyrequired
- 4xx 5xxThe error envelope.
curl -X POST "https://os.one.ml/api/v1/foundry/files" \
-H "Authorization: Bearer $GENESIS_API_KEY" \
-H "Content-Type: multipart/form-data" \
--data-binary @body.binimport { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_uploadFile', {
body: '<bytes>',
})Get file metadata
GET/v1/foundry/files/{file_id}
Parameters
file_idpath · stringrequired
Responses
- 200Successful response.
Response fields
idstringrequiredtype"file"requiredfilenamestringrequiredmime_typestringrequiredsize_bytesintegerrequiredmin 0
downloadablebooleanrequiredcreated_atanyrequired
- 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/files/$FILE_ID" \
-H "Authorization: Bearer $GENESIS_API_KEY"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_getFile', {
file_id: '<file_id>',
})Delete a tenant file
DELETE/v1/foundry/files/{file_id}
Parameters
file_idpath · stringrequired
Responses
- 200Successful response.
Response fields
A JSON object.
- 4xx 5xxThe error envelope.
curl -X DELETE "https://os.one.ml/api/v1/foundry/files/$FILE_ID" \
-H "Authorization: Bearer $GENESIS_API_KEY"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_deleteFile', {
file_id: '<file_id>',
})Content
Download tenant file content
GET/v1/foundry/files/{file_id}/content
Parameters
file_idpath · stringrequired
Responses
- 200File bytes.
Response fields
Type:
string (binary) - 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/files/$FILE_ID/content" \
-H "Authorization: Bearer $GENESIS_API_KEY"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_downloadFile', {
file_id: '<file_id>',
})Validate a video content lookup
GET/v1/foundry/videos/{id}/content
Parameters
idpath · stringrequired
Responses
- 501The request is validated, but this modality transport is not executable.
- 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/videos/$ID/content" \
-H "Authorization: Bearer $GENESIS_API_KEY"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_getVideoContent', {
id: '<id>',
})Fine tuning
List tenant fine-tuning jobs
GET/v1/foundry/fine_tuning/jobs
Responses
- 200Successful response.
Response fields
dataobject[]requireddata[].[].idstringrequireddata[].[].object"fine_tuning.job"requireddata[].[].providerstringrequireddata[].[].provider_job_idstring | nulldata[].[].modelstringrequireddata[].[].fine_tuned_modelstring | nulldata[].[].training_filestringrequireddata[].[].validation_filestring | nulldata[].[].status"validating" | "admitted" | "dispatching" | "queued" | "running" | "succeeded" | "failed" | "cancelling" | "cancelled" | "deleting" | "deleted"requireddata[].[].commercial_lane"byok"requireddata[].[].billing_state"pending" | "admitted" | "not_billable" | "receipt_committed" | "failed"requireddata[].[].provider_cost_evidenceobjectdata[].[].receiptobjectdata[].[].errorobject
- 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/fine_tuning/jobs" \
-H "Authorization: Bearer $GENESIS_API_KEY"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_listFineTuningJobs')Create an admitted fine-tuning job
POST/v1/foundry/fine_tuning/jobs
Request body application/json
provider"together"requiredmodelstringrequiredmin length 1 · max length 512
training_filestringrequiredvalidation_filestring | nullworkspace_idstring | nullcommercial_lane"byok"requiredn_epochsinteger | nullmin 1
n_checkpointsinteger | nullmin 0
n_evalsinteger | nullmin 0
batch_sizeinteger | nullmin 1
learning_ratenumber | nullsuffixstring | nullmin length 1 · max length 64
loraboolean | null
Responses
- 200Idempotent replay.
Response fields
idstringrequiredobject"fine_tuning.job"requiredproviderstringrequiredprovider_job_idstring | nullmodelstringrequiredfine_tuned_modelstring | nulltraining_filestringrequiredvalidation_filestring | nullstatus"validating" | "admitted" | "dispatching" | "queued" | "running" | "succeeded" | "failed" | "cancelling" | "cancelled" | "deleting" | "deleted"requiredcommercial_lane"byok"requiredbilling_state"pending" | "admitted" | "not_billable" | "receipt_committed" | "failed"requiredprovider_cost_evidenceobjectreceiptobjecterrorobject
- 202Provider job accepted.
Response fields
idstringrequiredobject"fine_tuning.job"requiredproviderstringrequiredprovider_job_idstring | nullmodelstringrequiredfine_tuned_modelstring | nulltraining_filestringrequiredvalidation_filestring | nullstatus"validating" | "admitted" | "dispatching" | "queued" | "running" | "succeeded" | "failed" | "cancelling" | "cancelled" | "deleting" | "deleted"requiredcommercial_lane"byok"requiredbilling_state"pending" | "admitted" | "not_billable" | "receipt_committed" | "failed"requiredprovider_cost_evidenceobjectreceiptobjecterrorobject
- 4xx 5xxThe error envelope.
curl -X POST "https://os.one.ml/api/v1/foundry/fine_tuning/jobs" \
-H "Authorization: Bearer $GENESIS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"provider": "together",
"model": "string",
"training_file": "string",
"commercial_lane": "byok"
}'import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_createFineTuningJob', {
body: {
provider: 'together',
model: 'string',
training_file: 'string',
commercial_lane: 'byok',
},
})Get and refresh a fine-tuning job
GET/v1/foundry/fine_tuning/jobs/{job_id}
Parameters
job_idpath · stringrequired
Responses
- 200Successful response.
Response fields
idstringrequiredobject"fine_tuning.job"requiredproviderstringrequiredprovider_job_idstring | nullmodelstringrequiredfine_tuned_modelstring | nulltraining_filestringrequiredvalidation_filestring | nullstatus"validating" | "admitted" | "dispatching" | "queued" | "running" | "succeeded" | "failed" | "cancelling" | "cancelled" | "deleting" | "deleted"requiredcommercial_lane"byok"requiredbilling_state"pending" | "admitted" | "not_billable" | "receipt_committed" | "failed"requiredprovider_cost_evidenceobjectreceiptobjecterrorobject
- 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/fine_tuning/jobs/$JOB_ID" \
-H "Authorization: Bearer $GENESIS_API_KEY"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_getFineTuningJob', {
job_id: '<job_id>',
})Delete a terminal provider fine-tuning job
DELETE/v1/foundry/fine_tuning/jobs/{job_id}
Parameters
job_idpath · stringrequired
Responses
- 200Successful response.
Response fields
A JSON object.
- 4xx 5xxThe error envelope.
curl -X DELETE "https://os.one.ml/api/v1/foundry/fine_tuning/jobs/$JOB_ID" \
-H "Authorization: Bearer $GENESIS_API_KEY"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_deleteFineTuningJob', {
job_id: '<job_id>',
})Cancel a provider fine-tuning job when contract-backed
POST/v1/foundry/fine_tuning/jobs/{job_id}/cancel
Parameters
job_idpath · stringrequired
Responses
- 200Successful response.
Response fields
idstringrequiredobject"fine_tuning.job"requiredproviderstringrequiredprovider_job_idstring | nullmodelstringrequiredfine_tuned_modelstring | nulltraining_filestringrequiredvalidation_filestring | nullstatus"validating" | "admitted" | "dispatching" | "queued" | "running" | "succeeded" | "failed" | "cancelling" | "cancelled" | "deleting" | "deleted"requiredcommercial_lane"byok"requiredbilling_state"pending" | "admitted" | "not_billable" | "receipt_committed" | "failed"requiredprovider_cost_evidenceobjectreceiptobjecterrorobject
- 4xx 5xxThe error envelope.
curl -X POST "https://os.one.ml/api/v1/foundry/fine_tuning/jobs/$JOB_ID/cancel" \
-H "Authorization: Bearer $GENESIS_API_KEY"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_cancelFineTuningJob', {
job_id: '<job_id>',
})List provider fine-tuning checkpoints when contract-backed
GET/v1/foundry/fine_tuning/jobs/{job_id}/checkpoints
Parameters
job_idpath · stringrequired
Responses
- 200Successful response.
Response fields
dataobject[]required
- 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/fine_tuning/jobs/$JOB_ID/checkpoints" \
-H "Authorization: Bearer $GENESIS_API_KEY"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_listFineTuningCheckpoints', {
job_id: '<job_id>',
})List normalized fine-tuning events
GET/v1/foundry/fine_tuning/jobs/{job_id}/events
Parameters
job_idpath · stringrequired
Responses
- 200Successful response.
Response fields
dataobject[]required
- 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/fine_tuning/jobs/$JOB_ID/events" \
-H "Authorization: Bearer $GENESIS_API_KEY"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_listFineTuningEvents', {
job_id: '<job_id>',
})List tenant private fine-tuned models
GET/v1/foundry/fine_tuning/models
Responses
- 200Successful response.
Response fields
A JSON object.
- 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/fine_tuning/models" \
-H "Authorization: Bearer $GENESIS_API_KEY"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_listFineTunedPrivateModels')Get a tenant private fine-tuned model
GET/v1/foundry/fine_tuning/models/{model_id}
Parameters
model_idpath · stringrequired
Responses
- 200Successful response.
Response fields
A JSON object.
- 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/fine_tuning/models/$MODEL_ID" \
-H "Authorization: Bearer $GENESIS_API_KEY"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_getFineTunedPrivateModel', {
model_id: '<model_id>',
})List contract-backed fine-tuning provider operations and executable lanes
GET/v1/foundry/fine_tuning/providers
Responses
- 200Successful response.
Response fields
A JSON object.
- 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/fine_tuning/providers" \
-H "Authorization: Bearer $GENESIS_API_KEY"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_listFineTuningProviders')Generations
Get a generation receipt
GET/v1/foundry/generations/{receipt_id}
Parameters
receipt_idpath · stringrequired
Responses
- 200Successful response.
Response fields
versionstringreceipt_idstringrequiredrequest_idstringrequiredmodel_idstringprovider_idstringlane"pay_as_you_go" | "subscription_entitled" | "byok"usageobjectusage.prompt_tokensintegermin 0
usage.completion_tokensintegermin 0
usage.total_tokensintegermin 0
usage.costnumbermin 0
signaturestring
- 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/generations/$RECEIPT_ID" \
-H "Authorization: Bearer $GENESIS_API_KEY"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_getGenerationReceipt', {
receipt_id: '<receipt_id>',
})Get a generation receipt by request ID
GET/v1/foundry/generations/by-request/{request_id}
Parameters
request_idpath · stringrequired
Responses
- 200Successful response.
Response fields
versionstringreceipt_idstringrequiredrequest_idstringrequiredmodel_idstringprovider_idstringlane"pay_as_you_go" | "subscription_entitled" | "byok"usageobjectusage.prompt_tokensintegermin 0
usage.completion_tokensintegermin 0
usage.total_tokensintegermin 0
usage.costnumbermin 0
signaturestring
- 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/generations/by-request/$REQUEST_ID" \
-H "Authorization: Bearer $GENESIS_API_KEY"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_getGenerationReceiptByRequest', {
request_id: '<request_id>',
})Images
Validate an image generation request
POST/v1/foundry/images
Request body application/json
modelstringrequiredpromptstringproviderobjectprovider.orderstring[]provider.onlystring[]provider.ignorestring[]provider.allow_fallbacksbooleanprovider.require_parametersbooleanprovider.zdrbooleanprovider.data_collection"allow" | "deny"provider.sortanyprovider.max_priceobject
Responses
- 501The request is validated, but this modality transport is not executable.
- 4xx 5xxThe error envelope.
curl -X POST "https://os.one.ml/api/v1/foundry/images" \
-H "Authorization: Bearer $GENESIS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "string"
}'import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_createImage', {
body: {
model: 'string',
},
})List image-capable models
GET/v1/foundry/images/models
Responses
- 200Successful response.
Response fields
dataobject[]required
- 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/images/models" \
-H "Authorization: Bearer $GENESIS_API_KEY"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_listImageModels')Keys
List tenant API keys
GET/v1/foundry/keys
Responses
- 200Successful response.
Response fields
A JSON object.
- 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/keys" \
-H "Authorization: Bearer $GENESIS_API_KEY"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_listApiKeys')Create a tenant API key
POST/v1/foundry/keys
Request body application/json
api_keystringrequiredlabelstring | nullscopesstring[]
Responses
- 200Successful response.
Response fields
A JSON object.
- 4xx 5xxThe error envelope.
curl -X POST "https://os.one.ml/api/v1/foundry/keys" \
-H "Authorization: Bearer $GENESIS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"api_key": "string"
}'import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_createApiKey', {
body: {
api_key: 'string',
},
})Delete a tenant API key
DELETE/v1/foundry/keys/{key_id}
Parameters
key_idpath · stringrequired
Responses
- 200Successful response.
Response fields
A JSON object.
- 4xx 5xxThe error envelope.
curl -X DELETE "https://os.one.ml/api/v1/foundry/keys/$KEY_ID" \
-H "Authorization: Bearer $GENESIS_API_KEY"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_deleteApiKey', {
key_id: '<key_id>',
})Models
List executable models
GET/v1/foundry/models
Responses
- 200Successful response.
Response fields
A JSON object.
- 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/models"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_listModels')Provider credential policies
List tenant provider credential policies
GET/v1/foundry/provider-credential-policies
Responses
- 200Successful response.
Response fields
A JSON object.
- 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/provider-credential-policies" \
-H "Authorization: Bearer $GENESIS_API_KEY"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_listProviderCredentialPolicies')Set a tenant provider credential policy
PUT/v1/foundry/provider-credential-policies/{provider_id}
Parameters
provider_idpath · stringrequired
Request body application/json
mode"platform" | "prefer_byok" | "require_byok"required
Responses
- 200Successful response.
Response fields
A JSON object.
- 4xx 5xxThe error envelope.
curl -X PUT "https://os.one.ml/api/v1/foundry/provider-credential-policies/$PROVIDER_ID" \
-H "Authorization: Bearer $GENESIS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"mode": "platform"
}'import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_setProviderCredentialPolicy', {
provider_id: '<provider_id>',
body: {
mode: 'platform',
},
})Provider keys
List tenant BYOK provider keys
GET/v1/foundry/provider-keys
Responses
- 200Successful response.
Response fields
A JSON object.
- 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/provider-keys" \
-H "Authorization: Bearer $GENESIS_API_KEY"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_listProviderKeys')Register a tenant BYOK provider key
POST/v1/foundry/provider-keys
Request body application/json
provider_idstringrequiredapi_keystringrequiredlabelstring | null
Responses
- 200Successful response.
Response fields
A JSON object.
- 4xx 5xxThe error envelope.
curl -X POST "https://os.one.ml/api/v1/foundry/provider-keys" \
-H "Authorization: Bearer $GENESIS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"provider_id": "string",
"api_key": "string"
}'import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_createProviderKey', {
body: {
provider_id: 'string',
api_key: 'string',
},
})Delete a tenant provider key
DELETE/v1/foundry/provider-keys/{provider_id}
Parameters
provider_idpath · stringrequired
Responses
- 200Successful response.
Response fields
A JSON object.
- 4xx 5xxThe error envelope.
curl -X DELETE "https://os.one.ml/api/v1/foundry/provider-keys/$PROVIDER_ID" \
-H "Authorization: Bearer $GENESIS_API_KEY"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_deleteProviderKey', {
provider_id: '<provider_id>',
})Enable or disable a tenant provider key
PATCH/v1/foundry/provider-keys/{provider_id}
Parameters
provider_idpath · stringrequired
Request body application/json
enabledbooleanrequired
Responses
- 200Successful response.
Response fields
A JSON object.
- 4xx 5xxThe error envelope.
curl -X PATCH "https://os.one.ml/api/v1/foundry/provider-keys/$PROVIDER_ID" \
-H "Authorization: Bearer $GENESIS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"enabled": true
}'import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_updateProviderKey', {
provider_id: '<provider_id>',
body: {
enabled: true,
},
})Receipts
Get the current receipt verification key
GET/v1/foundry/receipts/verification-keys/current
Responses
- 200Successful response.
Response fields
A JSON object.
- 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/receipts/verification-keys/current"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_getReceiptVerificationKey')Registry
Compare registry model dossiers
GET/v1/foundry/registry/compare
Responses
- 200Successful response.
Response fields
A JSON object.
- 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/registry/compare"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_compareRegistryModels')List registry facets
GET/v1/foundry/registry/facets
Responses
- 200Successful response.
Response fields
A JSON object.
- 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/registry/facets"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_listRegistryFacets')List registry labs
GET/v1/foundry/registry/labs
Responses
- 200Successful response.
Response fields
A JSON object.
- 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/registry/labs"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_listRegistryLabs')Get a registry lab dossier
GET/v1/foundry/registry/labs/{lab_id}
Parameters
lab_idpath · stringrequired
Responses
- 200Successful response.
Response fields
A JSON object.
- 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/registry/labs/$LAB_ID"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_getRegistryLab', {
lab_id: '<lab_id>',
})Get current model-base metadata
GET/v1/foundry/registry/model-base/current
Responses
- 200Successful response.
Response fields
A JSON object.
- 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/registry/model-base/current"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_getCurrentModelBase')List model-base releases
GET/v1/foundry/registry/model-base/releases
Responses
- 200Successful response.
Response fields
A JSON object.
- 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/registry/model-base/releases"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_listModelBaseReleases')List registry models
GET/v1/foundry/registry/models
Responses
- 200Successful response.
Response fields
A JSON object.
- 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/registry/models"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_listRegistryModels')Get a registry model
GET/v1/foundry/registry/models/{canonical_model_id}
Parameters
canonical_model_idpath · stringrequired
Responses
- 200Successful response.
Response fields
A JSON object.
- 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/registry/models/$CANONICAL_MODEL_ID"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_getRegistryModel', {
canonical_model_id: '<canonical_model_id>',
})Get a model dossier
GET/v1/foundry/registry/models/{canonical_model_id}/dossier
Parameters
canonical_model_idpath · stringrequired
Responses
- 200Successful response.
Response fields
A JSON object.
- 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/registry/models/$CANONICAL_MODEL_ID/dossier"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_getModelDossier', {
canonical_model_id: '<canonical_model_id>',
})List model access offers
GET/v1/foundry/registry/models/{canonical_model_id}/offers
Parameters
canonical_model_idpath · stringrequired
Responses
- 200Successful response.
Response fields
A JSON object.
- 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/registry/models/$CANONICAL_MODEL_ID/offers"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_listModelOffers', {
canonical_model_id: '<canonical_model_id>',
})List registry provenance
GET/v1/foundry/registry/provenance
Responses
- 200Successful response.
Response fields
A JSON object.
- 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/registry/provenance"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_listRegistryProvenance')List registry providers
GET/v1/foundry/registry/providers
Responses
- 200Successful response.
Response fields
A JSON object.
- 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/registry/providers"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_listRegistryProviders')Get a registry provider
GET/v1/foundry/registry/providers/{provider_id}
Parameters
provider_idpath · stringrequired
Responses
- 200Successful response.
Response fields
A JSON object.
- 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/registry/providers/$PROVIDER_ID"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_getRegistryProvider', {
provider_id: '<provider_id>',
})Get a provider dossier
GET/v1/foundry/registry/providers/{provider_id}/dossier
Parameters
provider_idpath · stringrequired
Responses
- 200Successful response.
Response fields
A JSON object.
- 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/registry/providers/$PROVIDER_ID/dossier"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_getProviderDossier', {
provider_id: '<provider_id>',
})List registry sources
GET/v1/foundry/registry/sources
Responses
- 200Successful response.
Response fields
A JSON object.
- 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/registry/sources"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_listRegistrySources')Rerank
Validate a rerank request
POST/v1/foundry/rerank
Request body application/json
modelstringrequiredquerystringrequireddocumentsany[]requiredtop_nintegermin 1
providerobjectprovider.orderstring[]provider.onlystring[]provider.ignorestring[]provider.allow_fallbacksbooleanprovider.require_parametersbooleanprovider.zdrbooleanprovider.data_collection"allow" | "deny"provider.sortanyprovider.max_priceobject
Responses
- 501The request is validated, but this modality transport is not executable.
- 4xx 5xxThe error envelope.
curl -X POST "https://os.one.ml/api/v1/foundry/rerank" \
-H "Authorization: Bearer $GENESIS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "string",
"query": "string",
"documents": [
"string"
]
}'import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_createRerank', {
body: {
model: 'string',
query: 'string',
documents: [
'string',
],
},
})Responses
Create an OpenAI Responses response
POST/v1/foundry/responses
Request body application/json
modelstringrequiredinputanyrequiredstreambooleanproviderobjectprovider.orderstring[]provider.onlystring[]provider.ignorestring[]provider.allow_fallbacksbooleanprovider.require_parametersbooleanprovider.zdrbooleanprovider.data_collection"allow" | "deny"provider.sortanyprovider.max_priceobject
Responses
- 200Successful response.
Response fields
idstringrequiredobjectstringmodelstringoutputobject[]usageobjectusage.prompt_tokensintegermin 0
usage.completion_tokensintegermin 0
usage.total_tokensintegermin 0
usage.costnumbermin 0
foundryobjectfoundry.request_idstringfoundry.receipt_idstringfoundry.billing_lane"pay_as_you_go" | "subscription_entitled" | "byok"
- 4xx 5xxThe error envelope.
curl -X POST "https://os.one.ml/api/v1/foundry/responses" \
-H "Authorization: Bearer $GENESIS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "string",
"input": "string"
}'import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_createResponse', {
body: {
model: 'string',
input: 'string',
},
})Videos
Validate a video generation request
POST/v1/foundry/videos
Request body application/json
modelstringrequiredpromptstringproviderobjectprovider.orderstring[]provider.onlystring[]provider.ignorestring[]provider.allow_fallbacksbooleanprovider.require_parametersbooleanprovider.zdrbooleanprovider.data_collection"allow" | "deny"provider.sortanyprovider.max_priceobject
Responses
- 501The request is validated, but this modality transport is not executable.
- 4xx 5xxThe error envelope.
curl -X POST "https://os.one.ml/api/v1/foundry/videos" \
-H "Authorization: Bearer $GENESIS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "string"
}'import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_createVideo', {
body: {
model: 'string',
},
})Validate a video job lookup
GET/v1/foundry/videos/{id}
Parameters
idpath · stringrequired
Responses
- 501The request is validated, but this modality transport is not executable.
- 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/videos/$ID" \
-H "Authorization: Bearer $GENESIS_API_KEY"import { Genesis } from '@lifesi/genesis'
const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('foundry_getVideo', {
id: '<id>',
})One Superintelligence, Inc. · Built from Genesis 0.1.12 and the live gateway on 2026-10-20. Support