Skip to main content

Embeddings Commands

See Embeddings module docs for permissions and data model.

soat create-embeddings​

Create embeddings

  • Method: POST
  • Path: /api/v1/embeddings

Usage​

soat create-embeddings

Options​

--project-id​

Project the call's usage is billed to. Required unless the credential is bound to a project, which then supplies its own. Requires write access to the named project.

  • Source: body
  • Required: no
  • Type: string
  • Example: proj_V1StGXR8Z5jdHi6B
--input​

Single text to embed.

  • Source: body
  • Required: no
  • Type: string
  • Example: The quick brown fox jumps over the lazy dog.
--inputs​

Batch of texts to embed. At most 256 per request — each input is one call to the embedding model, so a larger batch is refused (VALIDATION_FAILED) rather than queued. Split it across requests.

  • Source: body
  • Required: no
  • Type: array<string>
  • Example: ["The quick brown fox.","Pack my box with five dozen liquor jugs."]