OneOS Docs
Genesis 0.1.12 Console

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
admin foundry:gateway:invoke iam:read iam: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 under genesis.foundry
CLI
genesis foundry
MCP
Not in the MCP server

Operations

OperationEndpointAPI key
Validate a speech generation requestPOST/audio/speechAPI keys refused
Validate an audio transcription requestPOST/audio/transcriptionsAPI keys refused
Create the server-configured TEST credit checkoutPOST/billing/checkout/creditsSigned-in session
Read the current organization’s paid-credit balanceGET/billing/credits/balanceAPI keys refused
Read the current organization’s native Sandbox billing profileGET/billing/profileAPI keys refused
Ensure the current organization’s TEST billing profilePOST/billing/profile/ensureSigned-in session
Create a chat completionPOST/chat/completionsAPI keys refused
Create embeddingsPOST/embeddingsAPI keys refused
List tenant filesGET/filesAPI keys refused
Upload a tenant filePOST/filesAPI keys refused
Get file metadataGET/files/{file_id}API keys refused
Delete a tenant fileDELETE/files/{file_id}API keys refused
Download tenant file contentGET/files/{file_id}/contentAPI keys refused
List tenant fine-tuning jobsGET/fine_tuning/jobsAPI keys refused
Create an admitted fine-tuning jobPOST/fine_tuning/jobsAPI keys refused
Get and refresh a fine-tuning jobGET/fine_tuning/jobs/{job_id}API keys refused
Delete a terminal provider fine-tuning jobDELETE/fine_tuning/jobs/{job_id}API keys refused
Cancel a provider fine-tuning job when contract-backedPOST/fine_tuning/jobs/{job_id}/cancelAPI keys refused
List provider fine-tuning checkpoints when contract-backedGET/fine_tuning/jobs/{job_id}/checkpointsAPI keys refused
List normalized fine-tuning eventsGET/fine_tuning/jobs/{job_id}/eventsAPI keys refused
List tenant private fine-tuned modelsGET/fine_tuning/modelsAPI keys refused
Get a tenant private fine-tuned modelGET/fine_tuning/models/{model_id}API keys refused
List contract-backed fine-tuning provider operations and executable lanesGET/fine_tuning/providersAPI keys refused
Get a generation receiptGET/generations/{receipt_id}API keys refused
Get a generation receipt by request IDGET/generations/by-request/{request_id}API keys refused
Validate an image generation requestPOST/imagesAPI keys refused
List image-capable modelsGET/images/modelsAPI keys refused
List tenant API keysGET/keysAPI keys refused
Create a tenant API keyPOST/keysFailed with an API key
Delete a tenant API keyDELETE/keys/{key_id}Failed with an API key
List executable modelsGET/modelsTested with an API key
List tenant provider credential policiesGET/provider-credential-policiesAPI keys refused
Set a tenant provider credential policyPUT/provider-credential-policies/{provider_id}API keys refused
List tenant BYOK provider keysGET/provider-keysAPI keys refused
Register a tenant BYOK provider keyPOST/provider-keysAPI keys refused
Delete a tenant provider keyDELETE/provider-keys/{provider_id}API keys refused
Enable or disable a tenant provider keyPATCH/provider-keys/{provider_id}API keys refused
Get the current receipt verification keyGET/receipts/verification-keys/currentTested with an API key
Compare registry model dossiersGET/registry/compareFailed with an API key
List registry facetsGET/registry/facetsTested with an API key
List registry labsGET/registry/labsTested with an API key
Get a registry lab dossierGET/registry/labs/{lab_id}Tested with an API key
Get current model-base metadataGET/registry/model-base/currentTested with an API key
List model-base releasesGET/registry/model-base/releasesTested with an API key
List registry modelsGET/registry/modelsTested with an API key
Get a registry modelGET/registry/models/{canonical_model_id}Failed with an API key
Get a model dossierGET/registry/models/{canonical_model_id}/dossierFailed with an API key
List model access offersGET/registry/models/{canonical_model_id}/offersFailed with an API key
List registry provenanceGET/registry/provenanceFailed with an API key
List registry providersGET/registry/providersTested with an API key
Get a registry providerGET/registry/providers/{provider_id}Tested with an API key
Get a provider dossierGET/registry/providers/{provider_id}/dossierTested with an API key
List registry sourcesGET/registry/sourcesFailed with an API key
Validate a rerank requestPOST/rerankAPI keys refused
Create an OpenAI Responses responsePOST/responsesAPI keys refused
Validate a video generation requestPOST/videosAPI keys refused
Validate a video job lookupGET/videos/{id}API keys refused
Validate a video content lookupGET/videos/{id}/contentAPI keys refused

Audio

Validate a speech generation request

POST/v1/foundry/audio/speech

foundry:gateway:invokeAPI keys refusedfoundry_createAudioSpeech

Request body application/json

  • modelstringrequired
  • promptstring
  • providerobject
  • provider.orderstring[]
  • provider.onlystring[]
  • provider.ignorestring[]
  • provider.allow_fallbacksboolean
  • provider.require_parametersboolean
  • provider.zdrboolean
  • provider.data_collection"allow" | "deny"
  • provider.sortany
  • provider.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"
  }'

Validate an audio transcription request

POST/v1/foundry/audio/transcriptions

foundry:gateway:invokeAPI keys refusedfoundry_createAudioTranscription

Request body application/json

  • modelstringrequired
  • promptstring
  • providerobject
  • provider.orderstring[]
  • provider.onlystring[]
  • provider.ignorestring[]
  • provider.allow_fallbacksboolean
  • provider.require_parametersboolean
  • provider.zdrboolean
  • provider.data_collection"allow" | "deny"
  • provider.sortany
  • provider.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"
  }'

Billing

Create the server-configured TEST credit checkout

POST/v1/foundry/billing/checkout/credits

Signed-in sessionIdempotency-Key requiredAuthorized by the servicefoundry_createNativeCreditCheckout

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 · stringrequired

    Persisted 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_idstringrequired
    • stripe_checkout_session_idstringrequired
    • checkout_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 '{}'

Read the current organization’s paid-credit balance

GET/v1/foundry/billing/credits/balance

API keys refusedAuthorized by the servicefoundry_readNativeCreditBalance

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_idstringrequired
    • available_microdollarsintegerrequired

      min 0 · max 9007199254740991

    • granted_microdollarsintegerrequired

      min 0 · max 9007199254740991

    • reserved_microdollarsintegerrequired

      min 0 · max 9007199254740991

    • reserved_overage_microdollarsintegerrequired

      min 0 · max 9007199254740991

    • settlement_owner"foundry"required
    • launch_listedbooleanrequired

      Legacy 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"

Read the current organization’s native Sandbox billing profile

GET/v1/foundry/billing/profile

API keys refusedAuthorized by the servicefoundry_readBillingProfile

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
    • schemaVersion1required
    • status"ready" | "pending" | "attention_required"required
    • organizationIdstringrequired
    • billingAccountIdstringrequired
    • environmentId"sandbox"required
    • stripeAccountIdstringrequired
    • stripeCustomerIdstring | nullrequired
    • livemodefalserequired
    • canEnsurebooleanrequired
  • 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/billing/profile" \
  -H "Authorization: Bearer $GENESIS_API_KEY"

Ensure the current organization’s TEST billing profile

POST/v1/foundry/billing/profile/ensure

Signed-in sessionIdempotency-Key requiredAuthorized by the servicefoundry_ensureBillingProfile

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 · stringrequired

    Persisted 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
    • schemaVersion1required
    • status"ready" | "pending" | "attention_required"required
    • organizationIdstringrequired
    • billingAccountIdstringrequired
    • environmentId"sandbox"required
    • stripeAccountIdstringrequired
    • stripeCustomerIdstring | nullrequired
    • livemodefalserequired
    • canEnsurebooleanrequired
  • 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 '{}'

Chat

Create a chat completion

POST/v1/foundry/chat/completions

foundry:gateway:invokeAPI keys refusedfoundry_createChatCompletion

Request body application/json

  • modelstring
  • modelsstring[]
  • messagesobject[]required
  • messages[].[].rolestringrequired
  • messages[].[].contentanyrequired
  • streamboolean
  • providerobject
  • provider.orderstring[]
  • provider.onlystring[]
  • provider.ignorestring[]
  • provider.allow_fallbacksboolean
  • provider.require_parametersboolean
  • provider.zdrboolean
  • provider.data_collection"allow" | "deny"
  • provider.sortany
  • provider.max_priceobject

Responses

  • 200Successful response.
    Response fields
    • idstringrequired
    • modelstring
    • choicesobject[]required
    • usageobject
    • usage.prompt_tokensinteger

      min 0

    • usage.completion_tokensinteger

      min 0

    • usage.total_tokensinteger

      min 0

    • usage.costnumber

      min 0

    • foundryobject
    • foundry.request_idstring
    • foundry.receipt_idstring
    • foundry.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": []
  }'

Embeddings

Create embeddings

POST/v1/foundry/embeddings

foundry:gateway:invokeAPI keys refusedfoundry_createEmbedding

Request body application/json

  • modelstringrequired
  • inputanyrequired
  • dimensionsinteger

    min 1

Responses

  • 200Successful response.
    Response fields
    • objectstring
    • modelstring
    • dataobject[]required
    • usageobject
    • usage.prompt_tokensinteger

      min 0

    • usage.completion_tokensinteger

      min 0

    • usage.total_tokensinteger

      min 0

    • usage.costnumber

      min 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"
  }'

Files

List tenant files

GET/v1/foundry/files

adminAPI keys refusedfoundry_listFiles

Responses

  • 200Successful response.
    Response fields
    • dataobject[]required
    • data[].[].idstringrequired
    • data[].[].type"file"required
    • data[].[].filenamestringrequired
    • data[].[].mime_typestringrequired
    • data[].[].size_bytesintegerrequired

      min 0

    • data[].[].downloadablebooleanrequired
    • data[].[].created_atanyrequired
    • has_moreboolean
    • cursorstring | null
  • 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/files" \
  -H "Authorization: Bearer $GENESIS_API_KEY"

Upload a tenant file

POST/v1/foundry/files

adminAPI keys refusedfoundry_uploadFile

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
    • idstringrequired
    • type"file"required
    • filenamestringrequired
    • mime_typestringrequired
    • size_bytesintegerrequired

      min 0

    • downloadablebooleanrequired
    • created_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.bin

Get file metadata

GET/v1/foundry/files/{file_id}

adminAPI keys refusedfoundry_getFile

Parameters

  • file_idpath · stringrequired

Responses

  • 200Successful response.
    Response fields
    • idstringrequired
    • type"file"required
    • filenamestringrequired
    • mime_typestringrequired
    • size_bytesintegerrequired

      min 0

    • downloadablebooleanrequired
    • created_atanyrequired
  • 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/files/$FILE_ID" \
  -H "Authorization: Bearer $GENESIS_API_KEY"

Delete a tenant file

DELETE/v1/foundry/files/{file_id}

adminAPI keys refusedfoundry_deleteFile

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"

Content

Download tenant file content

GET/v1/foundry/files/{file_id}/content

adminAPI keys refusedfoundry_downloadFile

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"

Validate a video content lookup

GET/v1/foundry/videos/{id}/content

foundry:gateway:invokeAPI keys refusedfoundry_getVideoContent

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"

Fine tuning

List tenant fine-tuning jobs

GET/v1/foundry/fine_tuning/jobs

adminAPI keys refusedfoundry_listFineTuningJobs

Responses

  • 200Successful response.
    Response fields
    • dataobject[]required
    • data[].[].idstringrequired
    • data[].[].object"fine_tuning.job"required
    • data[].[].providerstringrequired
    • data[].[].provider_job_idstring | null
    • data[].[].modelstringrequired
    • data[].[].fine_tuned_modelstring | null
    • data[].[].training_filestringrequired
    • data[].[].validation_filestring | null
    • data[].[].status"validating" | "admitted" | "dispatching" | "queued" | "running" | "succeeded" | "failed" | "cancelling" | "cancelled" | "deleting" | "deleted"required
    • data[].[].commercial_lane"byok"required
    • data[].[].billing_state"pending" | "admitted" | "not_billable" | "receipt_committed" | "failed"required
    • data[].[].provider_cost_evidenceobject
    • data[].[].receiptobject
    • data[].[].errorobject
  • 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/fine_tuning/jobs" \
  -H "Authorization: Bearer $GENESIS_API_KEY"

Create an admitted fine-tuning job

POST/v1/foundry/fine_tuning/jobs

adminAPI keys refusedfoundry_createFineTuningJob

Request body application/json

  • provider"together"required
  • modelstringrequired

    min length 1 · max length 512

  • training_filestringrequired
  • validation_filestring | null
  • workspace_idstring | null
  • commercial_lane"byok"required
  • n_epochsinteger | null

    min 1

  • n_checkpointsinteger | null

    min 0

  • n_evalsinteger | null

    min 0

  • batch_sizeinteger | null

    min 1

  • learning_ratenumber | null
  • suffixstring | null

    min length 1 · max length 64

  • loraboolean | null

Responses

  • 200Idempotent replay.
    Response fields
    • idstringrequired
    • object"fine_tuning.job"required
    • providerstringrequired
    • provider_job_idstring | null
    • modelstringrequired
    • fine_tuned_modelstring | null
    • training_filestringrequired
    • validation_filestring | null
    • status"validating" | "admitted" | "dispatching" | "queued" | "running" | "succeeded" | "failed" | "cancelling" | "cancelled" | "deleting" | "deleted"required
    • commercial_lane"byok"required
    • billing_state"pending" | "admitted" | "not_billable" | "receipt_committed" | "failed"required
    • provider_cost_evidenceobject
    • receiptobject
    • errorobject
  • 202Provider job accepted.
    Response fields
    • idstringrequired
    • object"fine_tuning.job"required
    • providerstringrequired
    • provider_job_idstring | null
    • modelstringrequired
    • fine_tuned_modelstring | null
    • training_filestringrequired
    • validation_filestring | null
    • status"validating" | "admitted" | "dispatching" | "queued" | "running" | "succeeded" | "failed" | "cancelling" | "cancelled" | "deleting" | "deleted"required
    • commercial_lane"byok"required
    • billing_state"pending" | "admitted" | "not_billable" | "receipt_committed" | "failed"required
    • provider_cost_evidenceobject
    • receiptobject
    • errorobject
  • 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"
  }'

Get and refresh a fine-tuning job

GET/v1/foundry/fine_tuning/jobs/{job_id}

adminAPI keys refusedfoundry_getFineTuningJob

Parameters

  • job_idpath · stringrequired

Responses

  • 200Successful response.
    Response fields
    • idstringrequired
    • object"fine_tuning.job"required
    • providerstringrequired
    • provider_job_idstring | null
    • modelstringrequired
    • fine_tuned_modelstring | null
    • training_filestringrequired
    • validation_filestring | null
    • status"validating" | "admitted" | "dispatching" | "queued" | "running" | "succeeded" | "failed" | "cancelling" | "cancelled" | "deleting" | "deleted"required
    • commercial_lane"byok"required
    • billing_state"pending" | "admitted" | "not_billable" | "receipt_committed" | "failed"required
    • provider_cost_evidenceobject
    • receiptobject
    • errorobject
  • 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/fine_tuning/jobs/$JOB_ID" \
  -H "Authorization: Bearer $GENESIS_API_KEY"

Delete a terminal provider fine-tuning job

DELETE/v1/foundry/fine_tuning/jobs/{job_id}

adminAPI keys refusedfoundry_deleteFineTuningJob

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"

Cancel a provider fine-tuning job when contract-backed

POST/v1/foundry/fine_tuning/jobs/{job_id}/cancel

adminAPI keys refusedfoundry_cancelFineTuningJob

Parameters

  • job_idpath · stringrequired

Responses

  • 200Successful response.
    Response fields
    • idstringrequired
    • object"fine_tuning.job"required
    • providerstringrequired
    • provider_job_idstring | null
    • modelstringrequired
    • fine_tuned_modelstring | null
    • training_filestringrequired
    • validation_filestring | null
    • status"validating" | "admitted" | "dispatching" | "queued" | "running" | "succeeded" | "failed" | "cancelling" | "cancelled" | "deleting" | "deleted"required
    • commercial_lane"byok"required
    • billing_state"pending" | "admitted" | "not_billable" | "receipt_committed" | "failed"required
    • provider_cost_evidenceobject
    • receiptobject
    • errorobject
  • 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"

List provider fine-tuning checkpoints when contract-backed

GET/v1/foundry/fine_tuning/jobs/{job_id}/checkpoints

adminAPI keys refusedfoundry_listFineTuningCheckpoints

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"

List normalized fine-tuning events

GET/v1/foundry/fine_tuning/jobs/{job_id}/events

adminAPI keys refusedfoundry_listFineTuningEvents

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"

List tenant private fine-tuned models

GET/v1/foundry/fine_tuning/models

adminAPI keys refusedfoundry_listFineTunedPrivateModels

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"

Get a tenant private fine-tuned model

GET/v1/foundry/fine_tuning/models/{model_id}

adminAPI keys refusedfoundry_getFineTunedPrivateModel

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"

List contract-backed fine-tuning provider operations and executable lanes

GET/v1/foundry/fine_tuning/providers

adminAPI keys refusedfoundry_listFineTuningProviders

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"

Generations

Get a generation receipt

GET/v1/foundry/generations/{receipt_id}

foundry:gateway:invokeAPI keys refusedfoundry_getGenerationReceipt

Parameters

  • receipt_idpath · stringrequired

Responses

  • 200Successful response.
    Response fields
    • versionstring
    • receipt_idstringrequired
    • request_idstringrequired
    • model_idstring
    • provider_idstring
    • lane"pay_as_you_go" | "subscription_entitled" | "byok"
    • usageobject
    • usage.prompt_tokensinteger

      min 0

    • usage.completion_tokensinteger

      min 0

    • usage.total_tokensinteger

      min 0

    • usage.costnumber

      min 0

    • signaturestring
  • 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/generations/$RECEIPT_ID" \
  -H "Authorization: Bearer $GENESIS_API_KEY"

Get a generation receipt by request ID

GET/v1/foundry/generations/by-request/{request_id}

foundry:gateway:invokeAPI keys refusedfoundry_getGenerationReceiptByRequest

Parameters

  • request_idpath · stringrequired

Responses

  • 200Successful response.
    Response fields
    • versionstring
    • receipt_idstringrequired
    • request_idstringrequired
    • model_idstring
    • provider_idstring
    • lane"pay_as_you_go" | "subscription_entitled" | "byok"
    • usageobject
    • usage.prompt_tokensinteger

      min 0

    • usage.completion_tokensinteger

      min 0

    • usage.total_tokensinteger

      min 0

    • usage.costnumber

      min 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"

Images

Validate an image generation request

POST/v1/foundry/images

foundry:gateway:invokeAPI keys refusedfoundry_createImage

Request body application/json

  • modelstringrequired
  • promptstring
  • providerobject
  • provider.orderstring[]
  • provider.onlystring[]
  • provider.ignorestring[]
  • provider.allow_fallbacksboolean
  • provider.require_parametersboolean
  • provider.zdrboolean
  • provider.data_collection"allow" | "deny"
  • provider.sortany
  • provider.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"
  }'

List image-capable models

GET/v1/foundry/images/models

foundry:gateway:invokeAPI keys refusedfoundry_listImageModels

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"

Keys

List tenant API keys

GET/v1/foundry/keys

API keys refusedAuthorized by the servicefoundry_listApiKeys

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"

Create a tenant API key

POST/v1/foundry/keys

Failed with an API keyAuthorized by the servicefoundry_createApiKey

Request body application/json

  • api_keystringrequired
  • labelstring | null
  • scopesstring[]

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"
  }'

Delete a tenant API key

DELETE/v1/foundry/keys/{key_id}

Failed with an API keyAuthorized by the servicefoundry_deleteApiKey

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"

Models

List executable models

GET/v1/foundry/models

Tested with an API keyNo key neededfoundry_listModels

Responses

  • 200Successful response.
    Response fields

    A JSON object.

  • 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/models"

Provider credential policies

List tenant provider credential policies

GET/v1/foundry/provider-credential-policies

iam:readAPI keys refusedfoundry_listProviderCredentialPolicies

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"

Set a tenant provider credential policy

PUT/v1/foundry/provider-credential-policies/{provider_id}

iam:writeAPI keys refusedfoundry_setProviderCredentialPolicy

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"
  }'

Provider keys

List tenant BYOK provider keys

GET/v1/foundry/provider-keys

iam:readAPI keys refusedfoundry_listProviderKeys

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"

Register a tenant BYOK provider key

POST/v1/foundry/provider-keys

iam:writeAPI keys refusedfoundry_createProviderKey

Request body application/json

  • provider_idstringrequired
  • api_keystringrequired
  • labelstring | 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"
  }'

Delete a tenant provider key

DELETE/v1/foundry/provider-keys/{provider_id}

iam:writeAPI keys refusedfoundry_deleteProviderKey

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"

Enable or disable a tenant provider key

PATCH/v1/foundry/provider-keys/{provider_id}

iam:writeAPI keys refusedfoundry_updateProviderKey

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
  }'

Receipts

Get the current receipt verification key

GET/v1/foundry/receipts/verification-keys/current

Tested with an API keyNo key neededfoundry_getReceiptVerificationKey

Responses

  • 200Successful response.
    Response fields

    A JSON object.

  • 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/receipts/verification-keys/current"

Registry

Compare registry model dossiers

GET/v1/foundry/registry/compare

Failed with an API keyNo key neededfoundry_compareRegistryModels

Responses

  • 200Successful response.
    Response fields

    A JSON object.

  • 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/registry/compare"

List registry facets

GET/v1/foundry/registry/facets

Tested with an API keyNo key neededfoundry_listRegistryFacets

Responses

  • 200Successful response.
    Response fields

    A JSON object.

  • 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/registry/facets"

List registry labs

GET/v1/foundry/registry/labs

Tested with an API keyNo key neededfoundry_listRegistryLabs

Responses

  • 200Successful response.
    Response fields

    A JSON object.

  • 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/registry/labs"

Get a registry lab dossier

GET/v1/foundry/registry/labs/{lab_id}

Tested with an API keyNo key neededfoundry_getRegistryLab

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"

Get current model-base metadata

GET/v1/foundry/registry/model-base/current

Tested with an API keyNo key neededfoundry_getCurrentModelBase

Responses

  • 200Successful response.
    Response fields

    A JSON object.

  • 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/registry/model-base/current"

List model-base releases

GET/v1/foundry/registry/model-base/releases

Tested with an API keyNo key neededfoundry_listModelBaseReleases

Responses

  • 200Successful response.
    Response fields

    A JSON object.

  • 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/registry/model-base/releases"

List registry models

GET/v1/foundry/registry/models

Tested with an API keyNo key neededfoundry_listRegistryModels

Responses

  • 200Successful response.
    Response fields

    A JSON object.

  • 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/registry/models"

Get a registry model

GET/v1/foundry/registry/models/{canonical_model_id}

Failed with an API keyNo key neededfoundry_getRegistryModel

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"

Get a model dossier

GET/v1/foundry/registry/models/{canonical_model_id}/dossier

Failed with an API keyNo key neededfoundry_getModelDossier

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"

List model access offers

GET/v1/foundry/registry/models/{canonical_model_id}/offers

Failed with an API keyNo key neededfoundry_listModelOffers

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"

List registry provenance

GET/v1/foundry/registry/provenance

Failed with an API keyNo key neededfoundry_listRegistryProvenance

Responses

  • 200Successful response.
    Response fields

    A JSON object.

  • 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/registry/provenance"

List registry providers

GET/v1/foundry/registry/providers

Tested with an API keyNo key neededfoundry_listRegistryProviders

Responses

  • 200Successful response.
    Response fields

    A JSON object.

  • 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/registry/providers"

Get a registry provider

GET/v1/foundry/registry/providers/{provider_id}

Tested with an API keyNo key neededfoundry_getRegistryProvider

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"

Get a provider dossier

GET/v1/foundry/registry/providers/{provider_id}/dossier

Tested with an API keyNo key neededfoundry_getProviderDossier

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"

List registry sources

GET/v1/foundry/registry/sources

Failed with an API keyNo key neededfoundry_listRegistrySources

Responses

  • 200Successful response.
    Response fields

    A JSON object.

  • 4xx 5xxThe error envelope.
curl "https://os.one.ml/api/v1/foundry/registry/sources"

Rerank

Validate a rerank request

POST/v1/foundry/rerank

foundry:gateway:invokeAPI keys refusedfoundry_createRerank

Request body application/json

  • modelstringrequired
  • querystringrequired
  • documentsany[]required
  • top_ninteger

    min 1

  • providerobject
  • provider.orderstring[]
  • provider.onlystring[]
  • provider.ignorestring[]
  • provider.allow_fallbacksboolean
  • provider.require_parametersboolean
  • provider.zdrboolean
  • provider.data_collection"allow" | "deny"
  • provider.sortany
  • provider.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"
    ]
  }'

Responses

Create an OpenAI Responses response

POST/v1/foundry/responses

foundry:gateway:invokeAPI keys refusedfoundry_createResponse

Request body application/json

  • modelstringrequired
  • inputanyrequired
  • streamboolean
  • providerobject
  • provider.orderstring[]
  • provider.onlystring[]
  • provider.ignorestring[]
  • provider.allow_fallbacksboolean
  • provider.require_parametersboolean
  • provider.zdrboolean
  • provider.data_collection"allow" | "deny"
  • provider.sortany
  • provider.max_priceobject

Responses

  • 200Successful response.
    Response fields
    • idstringrequired
    • objectstring
    • modelstring
    • outputobject[]
    • usageobject
    • usage.prompt_tokensinteger

      min 0

    • usage.completion_tokensinteger

      min 0

    • usage.total_tokensinteger

      min 0

    • usage.costnumber

      min 0

    • foundryobject
    • foundry.request_idstring
    • foundry.receipt_idstring
    • foundry.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"
  }'

Videos

Validate a video generation request

POST/v1/foundry/videos

foundry:gateway:invokeAPI keys refusedfoundry_createVideo

Request body application/json

  • modelstringrequired
  • promptstring
  • providerobject
  • provider.orderstring[]
  • provider.onlystring[]
  • provider.ignorestring[]
  • provider.allow_fallbacksboolean
  • provider.require_parametersboolean
  • provider.zdrboolean
  • provider.data_collection"allow" | "deny"
  • provider.sortany
  • provider.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"
  }'

Validate a video job lookup

GET/v1/foundry/videos/{id}

foundry:gateway:invokeAPI keys refusedfoundry_getVideo

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"

One Superintelligence, Inc. · Built from Genesis 0.1.12 and the live gateway on 2026-10-20. Support