Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

International Business Machines Text Generation API

Generate text using foundation models.

International Business Machines Text Generation API is one of 22 APIs that International Business Machines publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 8 JSON Schema definitions.

Tagged areas include Text Generation. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, and 8 JSON Schemas.

This API exposes 3 operations across 3 paths, and defines 4 schemas. It is described by OpenAPI 3.0.3, at version 1.0.0.

Requests are made against 3 base URLs: https://s3.us-south.cloud-object-storage.appdomain.cloud, https://s3.eu-de.cloud-object-storage.appdomain.cloud, https://s3.eu-gb.cloud-object-storage.appdomain.cloud.

3 operations 3 paths 4 schemas 3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0.0
Servers
https://s3.us-south.cloud-object-storage.appdomain.cloud
https://s3.eu-de.cloud-object-storage.appdomain.cloud
https://s3.eu-gb.cloud-object-storage.appdomain.cloud
Authentication
HTTP Bearer
Contact
Resource Areas
1

Authentication & Security 1

International Business Machines Text Generation API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (IAM Token) (bearerAuth). By default, every request must be authenticated.

Paths & Operations 3

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

Text Generation 3

Generate text using foundation models.

POST
/ml/v1/text/generation
International Business Machines Generate text
textGeneration 1 param body → 200400401
POST
/ml/v1/text/generation_stream
International Business Machines Generate text (streaming)
textGenerationStream 1 param body → 200
POST
/ml/v1/text/tokenization
International Business Machines Tokenize text
textTokenization 1 param body → 200

Schemas 4

The contract defines 4 schemas that model the data the API accepts and returns. The most detailed are TextGenerationRequest (4 properties), TextGenerationResponse (3 properties), TokenizationRequest (3 properties), TokenizationResponse (2 properties). Each schema is shown below with its type and property counts.

TokenizationRequest
object
3 properties 3 required
TokenizationResponse
object
2 properties
TextGenerationResponse
object
3 properties
TextGenerationRequest
object
4 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

international-business-machines-text-generation-api-openapi.yml Raw ↑

Other APIs International Business Machines publishes across the network.

International Business Machines Analyze API
International Business Machines Buckets API
International Business Machines Clusters API
International Business Machines Custom Language Models API
International Business Machines Embeddings API
International Business Machines Environments API
International Business Machines Instances API
International Business Machines Messages API
International Business Machines Models API
International Business Machines Objects API
International Business Machines Pronunciation API
International Business Machines Recognition API