How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Aleph Alpha Tasks API

Requests for different types of tasks you can request with our models.

Aleph Alpha Tasks API is one of 37 APIs that Aleph Alpha publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Task. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 16 operations across 16 paths, and defines 59 schemas. It is described by OpenAPI 3.2.0, at version 4.7.0.

Requests are made against a single base URL, {host}/v1.

16 operations 16 paths 59 schemas 1 GET15 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
4.7.0
Base URL
https://api.aleph-alpha.com
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Aleph Alpha Tasks API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (token).

  • token — Can be generated in your [Aleph Alpha profile](https://app.aleph-alpha.com/profile)

Paths & Operations 16

Across 16 paths, the API surfaces 16 operations — 1 GET, 15 POST. Each is listed below with its method, path, parameters, and response codes.

tasks 16

Requests for different types of tasks you can request with our models.

POST
/complete
Completion
complete 1 param body → 200
POST
/complete/json
JSON Completion
completeJson 1 param body → 200
POST
/chat/completions
Chat
chatCompletions 1 param body → 200
POST
/embeddings
Embeddings
embeddings 1 param body → 200
POST
/semantic_embed
Semantic Embeddings
semanticEmbed 1 param body → 200
POST
/batch_semantic_embed
Batched Semantic Embeddings
batchSemanticEmbed 1 param body → 200
POST
/instructable_embed
Semantic Embeddings with instructions
instructableEmbed 1 param body → 200
POST
/embeddeprecated
Embeddings (Deprecated)
embed 1 param body → 200
POST
/evaluate
Evaluate
evaluate 1 param body → 200
POST
/explain
Explanation
explain 1 param body → 200
POST
/tokenize
Tokenize
tokenize body → 200
POST
/detokenize
Detokenize
detokenize body → 200
GET
/users/me/requestsdeprecated
Query Recent Usage (Deprecated)
recentRequests → 200
POST
/transcribe
Transcribe audio
transcribe body → 200
POST
/translate
Translation
translate 1 param body → 200
POST
/rerank
Rerank
rerank 1 param body → 200

Schemas 59

The contract defines 59 schemas that model the data the API accepts and returns. The most detailed are CompletionRequest (37 properties), ChatRequest (22 properties), ExplanationRequest (12 properties), EmbeddingRequest (10 properties). Each schema is shown below with its type and property counts.

ChatResponseTopLogprob
object
3 properties 3 required
FunctionObject
object
4 properties 1 required
SteeringConceptRef
ChatRequestTool
object
A function tool that can be used to generate a response.
2 properties 2 required
EmbeddingV2ResponseData
object
3 properties 3 required
SemanticEmbeddingRequest
object
8 properties 2 required
MultimodalPrompt
array
An array of prompt items for multimodal request. Can support any combination of text, images, and token ids.
TextPromptItemImportance
object
Explains the importance of a text prompt item. The amount of items in the "scores" array depends on the granularity setting. Each score object contains an incl…
2 properties
RerankRequest
object
3 properties 2 required
TargetItemImportance
object
Explains the importance of text in the target string that came before the currently to-be-explained target token. The amount of items in the "scores" array dep…
2 properties
TranslationRequest
object
3 properties 3 required
Prompt
This field is used to send prompts to the model. A prompt can either be a text prompt or a multimodal prompt. A text prompt is a string of text. A multimodal p…
EmbeddingRequest
object
10 properties 2 required
RecentRequestsResponse
array
FunctionParameters
object
The parameters the functions accepts, described as a JSON Schema object. Omitting parameters defines a function with an empty parameter list.
CompletionSummary
object
Response object being returned once per completion request after all streams have finished.
4 properties 3 required
ChatRequestMessageToolCall
object
A call to a function tool created by the model.
3 properties 3 required
Hosting
string
Optional parameter that specifies which datacenters may process the request. You can either set the parameter to "aleph-alpha" or omit it (defaulting to null).…
ImagePromptItemImportance
object
Explains the importance of an image prompt item. The amount of items in the "scores" array depends on the granularity setting. Each score object contains the t…
2 properties
ChatResponse
object
7 properties
ExplanationResponse
object
The top-level response data structure that will be returned from an explanation request.
2 properties
EvaluationResponse
object
3 properties
WorkerSteeringConcept
string
A reference to a worker-defined steering concept. The value must be a string starting with worker/ followed by a name matching the pattern ^[a-zA-Z0-9-]{1,64}$.
RerankResponse
object
2 properties
ExplanationRequest
object
12 properties 3 required
TokenIdsPromptItem
object
3 properties 2 required
TextPromptItem
object
3 properties 2 required
ChatRequest
object
22 properties 2 required
DetokenizationResponse
object
1 property
TranscribeResponse
object
5 properties
CompletionResponse
object
Response object being returned when streaming is disabled.
5 properties
TokenizationRequest
object
4 properties 4 required
BatchSemanticEmbeddingRequest
object
8 properties 2 required
ImagePromptItem
object
6 properties 2 required
TranslationResponse
object
5 properties
ChatRequestMessage
object
5 properties 2 required
EmbeddingV2Usage
object
2 properties 2 required
StreamChunk
object
Response object being returned continuously per completion stream during transmission.
6 properties 3 required
TranscribeSegment
object
4 properties
SemanticEmbeddingCompressToSize
integer
The default behavior is to return the full embedding with 5120 dimensions. With this parameter you can compress the returned embedding to 128 dimensions. The c…
BatchSemanticEmbeddingResponse
object
3 properties
CompletionRequest
object
37 properties 2 required
ChatResponseMessage
object
5 properties 1 required
EvaluationRequest
object
6 properties 3 required
TranscribeRequest
object
2 properties
SteeringConceptId
string
The ID of a steering concept that was created using the steeringconcepts endpoint.
InstructableEmbeddingRequest
object
7 properties 2 required
TokenIdsPromptItemImportance
object
Explains the importance of a request prompt item of type "tokenids". Will contain one floating point importance value for each token in the same order as in th…
2 properties
EmbeddingResponse
object
4 properties
OptimizedPrompt
array
Describes prompt after optimizations. This field is only returned if the flag disableoptimizations flag is not set and the prompt has actually changed.
TokenizationResponse
object
2 properties
EmbeddingV2Request
object
5 properties 2 required
ChatResponseLogprobs
object
4 properties 4 required
SemanticEmbeddingResponse
object
3 properties
ResponseFormat
object
An object specifying the format that the model must output. Setting to { "type": "jsonschema" } enables structured output mode.
2 properties 2 required
StreamSummary
object
Response object being returned once per completion stream at the end of a stream.
4 properties 4 required
TranslationSegment
object
3 properties
DetokenizationRequest
object
2 properties 2 required
EmbeddingV2Response
object
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

aleph-alpha-tasks-api-openapi.yml Raw ↑

Other APIs Aleph Alpha publishes across the network.

Aleph Alpha API description API
Aleph Alpha Application Traces API
Aleph Alpha Benchmark Executions API
Aleph Alpha Benchmarks API
Aleph Alpha Cluster API
Aleph Alpha Collection API
Aleph Alpha Connectors API
Aleph Alpha Conversations API
Aleph Alpha Datasets API
Aleph Alpha Document API
Aleph Alpha Downloads API
Aleph Alpha Evaluation Datasets API
Where this information came from

This is an independent, third-party profile of Aleph Alpha Tasks API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.