Skip to content

Commit 7fd4830

Browse files
RobertCraigiestainless-app[bot]
authored andcommitted
feat(api): general availability updates
The following APIs are now GA and have been moved out of the beta namespace: - Prompt caching - Token counting - PDF Support - The Batch API This commit also adds new endpoints for listing available models. https://docs.anthropic.com/en/release-notes/api
1 parent 327b611 commit 7fd4830

25 files changed

+1407
-1452
lines changed

.stats.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,2 @@
1-
configured_endpoints: 10
2-
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/anthropic-73443ebfebee64b8ec0ebbacd2521d6b6aa900e9526ec97abdcbcff0c0955d9b.yml
1+
configured_endpoints: 19
2+
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/anthropic-be055148d227480fcacc9086c37ac8009dcb487731069ada51af35044f65bee4.yml

api.md

Lines changed: 102 additions & 59 deletions
Original file line numberDiff line numberDiff line change
@@ -1,65 +1,131 @@
11
# Anthropic
22

3+
# Shared
4+
5+
Types:
6+
7+
- <code><a href="./src/resources/shared.ts">APIErrorObject</a></code>
8+
- <code><a href="./src/resources/shared.ts">AuthenticationError</a></code>
9+
- <code><a href="./src/resources/shared.ts">BillingError</a></code>
10+
- <code><a href="./src/resources/shared.ts">ErrorObject</a></code>
11+
- <code><a href="./src/resources/shared.ts">ErrorResponse</a></code>
12+
- <code><a href="./src/resources/shared.ts">GatewayTimeoutError</a></code>
13+
- <code><a href="./src/resources/shared.ts">InvalidRequestError</a></code>
14+
- <code><a href="./src/resources/shared.ts">NotFoundError</a></code>
15+
- <code><a href="./src/resources/shared.ts">OverloadedError</a></code>
16+
- <code><a href="./src/resources/shared.ts">PermissionError</a></code>
17+
- <code><a href="./src/resources/shared.ts">RateLimitError</a></code>
18+
319
# Messages
420

521
Types:
622

7-
- <code><a href="./src/resources/messages.ts">ContentBlock</a></code>
8-
- <code><a href="./src/resources/messages.ts">ContentBlockDeltaEvent</a></code>
9-
- <code><a href="./src/resources/messages.ts">ContentBlockParam</a></code>
10-
- <code><a href="./src/resources/messages.ts">ContentBlockStartEvent</a></code>
11-
- <code><a href="./src/resources/messages.ts">ContentBlockStopEvent</a></code>
12-
- <code><a href="./src/resources/messages.ts">ImageBlockParam</a></code>
13-
- <code><a href="./src/resources/messages.ts">InputJSONDelta</a></code>
14-
- <code><a href="./src/resources/messages.ts">Message</a></code>
15-
- <code><a href="./src/resources/messages.ts">MessageDeltaEvent</a></code>
16-
- <code><a href="./src/resources/messages.ts">MessageDeltaUsage</a></code>
17-
- <code><a href="./src/resources/messages.ts">MessageParam</a></code>
18-
- <code><a href="./src/resources/messages.ts">MessageStartEvent</a></code>
19-
- <code><a href="./src/resources/messages.ts">MessageStopEvent</a></code>
20-
- <code><a href="./src/resources/messages.ts">MessageStreamEvent</a></code>
21-
- <code><a href="./src/resources/messages.ts">Metadata</a></code>
22-
- <code><a href="./src/resources/messages.ts">Model</a></code>
23-
- <code><a href="./src/resources/messages.ts">RawContentBlockDeltaEvent</a></code>
24-
- <code><a href="./src/resources/messages.ts">RawContentBlockStartEvent</a></code>
25-
- <code><a href="./src/resources/messages.ts">RawContentBlockStopEvent</a></code>
26-
- <code><a href="./src/resources/messages.ts">RawMessageDeltaEvent</a></code>
27-
- <code><a href="./src/resources/messages.ts">RawMessageStartEvent</a></code>
28-
- <code><a href="./src/resources/messages.ts">RawMessageStopEvent</a></code>
29-
- <code><a href="./src/resources/messages.ts">RawMessageStreamEvent</a></code>
30-
- <code><a href="./src/resources/messages.ts">TextBlock</a></code>
31-
- <code><a href="./src/resources/messages.ts">TextBlockParam</a></code>
32-
- <code><a href="./src/resources/messages.ts">TextDelta</a></code>
33-
- <code><a href="./src/resources/messages.ts">Tool</a></code>
34-
- <code><a href="./src/resources/messages.ts">ToolChoice</a></code>
35-
- <code><a href="./src/resources/messages.ts">ToolChoiceAny</a></code>
36-
- <code><a href="./src/resources/messages.ts">ToolChoiceAuto</a></code>
37-
- <code><a href="./src/resources/messages.ts">ToolChoiceTool</a></code>
38-
- <code><a href="./src/resources/messages.ts">ToolResultBlockParam</a></code>
39-
- <code><a href="./src/resources/messages.ts">ToolUseBlock</a></code>
40-
- <code><a href="./src/resources/messages.ts">ToolUseBlockParam</a></code>
41-
- <code><a href="./src/resources/messages.ts">Usage</a></code>
23+
- <code><a href="./src/resources/messages/messages.ts">Base64PDFSource</a></code>
24+
- <code><a href="./src/resources/messages/messages.ts">CacheControlEphemeral</a></code>
25+
- <code><a href="./src/resources/messages/messages.ts">ContentBlock</a></code>
26+
- <code><a href="./src/resources/messages/messages.ts">ContentBlockDeltaEvent</a></code>
27+
- <code><a href="./src/resources/messages/messages.ts">ContentBlockParam</a></code>
28+
- <code><a href="./src/resources/messages/messages.ts">ContentBlockStartEvent</a></code>
29+
- <code><a href="./src/resources/messages/messages.ts">ContentBlockStopEvent</a></code>
30+
- <code><a href="./src/resources/messages/messages.ts">DocumentBlockParam</a></code>
31+
- <code><a href="./src/resources/messages/messages.ts">ImageBlockParam</a></code>
32+
- <code><a href="./src/resources/messages/messages.ts">InputJSONDelta</a></code>
33+
- <code><a href="./src/resources/messages/messages.ts">Message</a></code>
34+
- <code><a href="./src/resources/messages/messages.ts">MessageDeltaEvent</a></code>
35+
- <code><a href="./src/resources/messages/messages.ts">MessageDeltaUsage</a></code>
36+
- <code><a href="./src/resources/messages/messages.ts">MessageParam</a></code>
37+
- <code><a href="./src/resources/messages/messages.ts">MessageStartEvent</a></code>
38+
- <code><a href="./src/resources/messages/messages.ts">MessageStopEvent</a></code>
39+
- <code><a href="./src/resources/messages/messages.ts">MessageStreamEvent</a></code>
40+
- <code><a href="./src/resources/messages/messages.ts">MessageTokensCount</a></code>
41+
- <code><a href="./src/resources/messages/messages.ts">Metadata</a></code>
42+
- <code><a href="./src/resources/messages/messages.ts">Model</a></code>
43+
- <code><a href="./src/resources/messages/messages.ts">RawContentBlockDeltaEvent</a></code>
44+
- <code><a href="./src/resources/messages/messages.ts">RawContentBlockStartEvent</a></code>
45+
- <code><a href="./src/resources/messages/messages.ts">RawContentBlockStopEvent</a></code>
46+
- <code><a href="./src/resources/messages/messages.ts">RawMessageDeltaEvent</a></code>
47+
- <code><a href="./src/resources/messages/messages.ts">RawMessageStartEvent</a></code>
48+
- <code><a href="./src/resources/messages/messages.ts">RawMessageStopEvent</a></code>
49+
- <code><a href="./src/resources/messages/messages.ts">RawMessageStreamEvent</a></code>
50+
- <code><a href="./src/resources/messages/messages.ts">TextBlock</a></code>
51+
- <code><a href="./src/resources/messages/messages.ts">TextBlockParam</a></code>
52+
- <code><a href="./src/resources/messages/messages.ts">TextDelta</a></code>
53+
- <code><a href="./src/resources/messages/messages.ts">Tool</a></code>
54+
- <code><a href="./src/resources/messages/messages.ts">ToolChoice</a></code>
55+
- <code><a href="./src/resources/messages/messages.ts">ToolChoiceAny</a></code>
56+
- <code><a href="./src/resources/messages/messages.ts">ToolChoiceAuto</a></code>
57+
- <code><a href="./src/resources/messages/messages.ts">ToolChoiceTool</a></code>
58+
- <code><a href="./src/resources/messages/messages.ts">ToolResultBlockParam</a></code>
59+
- <code><a href="./src/resources/messages/messages.ts">ToolUseBlock</a></code>
60+
- <code><a href="./src/resources/messages/messages.ts">ToolUseBlockParam</a></code>
61+
- <code><a href="./src/resources/messages/messages.ts">Usage</a></code>
4262

4363
Methods:
4464

45-
- <code title="post /v1/messages">client.messages.<a href="./src/resources/messages.ts">create</a>({ ...params }) -> Message</code>
65+
- <code title="post /v1/messages">client.messages.<a href="./src/resources/messages/messages.ts">create</a>({ ...params }) -> Message</code>
66+
- <code title="post /v1/messages/count_tokens">client.messages.<a href="./src/resources/messages/messages.ts">countTokens</a>({ ...params }) -> MessageTokensCount</code>
4667
- <code>client.messages.<a href="./src/resources/messages.ts">stream</a>(body, options?) -> MessageStream</code>
4768

69+
## Batches
70+
71+
Types:
72+
73+
- <code><a href="./src/resources/messages/batches.ts">MessageBatch</a></code>
74+
- <code><a href="./src/resources/messages/batches.ts">MessageBatchCanceledResult</a></code>
75+
- <code><a href="./src/resources/messages/batches.ts">MessageBatchErroredResult</a></code>
76+
- <code><a href="./src/resources/messages/batches.ts">MessageBatchExpiredResult</a></code>
77+
- <code><a href="./src/resources/messages/batches.ts">MessageBatchIndividualResponse</a></code>
78+
- <code><a href="./src/resources/messages/batches.ts">MessageBatchRequestCounts</a></code>
79+
- <code><a href="./src/resources/messages/batches.ts">MessageBatchResult</a></code>
80+
- <code><a href="./src/resources/messages/batches.ts">MessageBatchSucceededResult</a></code>
81+
82+
Methods:
83+
84+
- <code title="post /v1/messages/batches">client.messages.batches.<a href="./src/resources/messages/batches.ts">create</a>({ ...params }) -> MessageBatch</code>
85+
- <code title="get /v1/messages/batches/{message_batch_id}">client.messages.batches.<a href="./src/resources/messages/batches.ts">retrieve</a>(messageBatchId) -> MessageBatch</code>
86+
- <code title="get /v1/messages/batches">client.messages.batches.<a href="./src/resources/messages/batches.ts">list</a>({ ...params }) -> MessageBatchesPage</code>
87+
- <code title="post /v1/messages/batches/{message_batch_id}/cancel">client.messages.batches.<a href="./src/resources/messages/batches.ts">cancel</a>(messageBatchId) -> MessageBatch</code>
88+
- <code title="get /v1/messages/batches/{message_batch_id}/results">client.messages.batches.<a href="./src/resources/messages/batches.ts">results</a>(messageBatchId) -> Response</code>
89+
90+
# Models
91+
92+
Types:
93+
94+
- <code><a href="./src/resources/models.ts">ModelInfo</a></code>
95+
96+
Methods:
97+
98+
- <code title="get /v1/models/{model_id}">client.models.<a href="./src/resources/models.ts">retrieve</a>(modelId) -> ModelInfo</code>
99+
- <code title="get /v1/models">client.models.<a href="./src/resources/models.ts">list</a>({ ...params }) -> ModelInfosPage</code>
100+
48101
# Beta
49102

50103
Types:
51104

52105
- <code><a href="./src/resources/beta/beta.ts">AnthropicBeta</a></code>
53106
- <code><a href="./src/resources/beta/beta.ts">BetaAPIError</a></code>
54107
- <code><a href="./src/resources/beta/beta.ts">BetaAuthenticationError</a></code>
108+
- <code><a href="./src/resources/beta/beta.ts">BetaBillingError</a></code>
55109
- <code><a href="./src/resources/beta/beta.ts">BetaError</a></code>
56110
- <code><a href="./src/resources/beta/beta.ts">BetaErrorResponse</a></code>
111+
- <code><a href="./src/resources/beta/beta.ts">BetaGatewayTimeoutError</a></code>
57112
- <code><a href="./src/resources/beta/beta.ts">BetaInvalidRequestError</a></code>
58113
- <code><a href="./src/resources/beta/beta.ts">BetaNotFoundError</a></code>
59114
- <code><a href="./src/resources/beta/beta.ts">BetaOverloadedError</a></code>
60115
- <code><a href="./src/resources/beta/beta.ts">BetaPermissionError</a></code>
61116
- <code><a href="./src/resources/beta/beta.ts">BetaRateLimitError</a></code>
62117

118+
## Models
119+
120+
Types:
121+
122+
- <code><a href="./src/resources/beta/models.ts">BetaModelInfo</a></code>
123+
124+
Methods:
125+
126+
- <code title="get /v1/models/{model_id}?beta=true">client.beta.models.<a href="./src/resources/beta/models.ts">retrieve</a>(modelId) -> BetaModelInfo</code>
127+
- <code title="get /v1/models?beta=true">client.beta.models.<a href="./src/resources/beta/models.ts">list</a>({ ...params }) -> BetaModelInfosPage</code>
128+
63129
## Messages
64130

65131
Types:
@@ -125,26 +191,3 @@ Methods:
125191
- <code title="get /v1/messages/batches?beta=true">client.beta.messages.batches.<a href="./src/resources/beta/messages/batches.ts">list</a>({ ...params }) -> BetaMessageBatchesPage</code>
126192
- <code title="post /v1/messages/batches/{message_batch_id}/cancel?beta=true">client.beta.messages.batches.<a href="./src/resources/beta/messages/batches.ts">cancel</a>(messageBatchId, { ...params }) -> BetaMessageBatch</code>
127193
- <code title="get /v1/messages/batches/{message_batch_id}/results?beta=true">client.beta.messages.batches.<a href="./src/resources/beta/messages/batches.ts">results</a>(messageBatchId, { ...params }) -> Response</code>
128-
129-
## PromptCaching
130-
131-
### Messages
132-
133-
Types:
134-
135-
- <code><a href="./src/resources/beta/prompt-caching/messages.ts">PromptCachingBetaCacheControlEphemeral</a></code>
136-
- <code><a href="./src/resources/beta/prompt-caching/messages.ts">PromptCachingBetaImageBlockParam</a></code>
137-
- <code><a href="./src/resources/beta/prompt-caching/messages.ts">PromptCachingBetaMessage</a></code>
138-
- <code><a href="./src/resources/beta/prompt-caching/messages.ts">PromptCachingBetaMessageParam</a></code>
139-
- <code><a href="./src/resources/beta/prompt-caching/messages.ts">PromptCachingBetaTextBlockParam</a></code>
140-
- <code><a href="./src/resources/beta/prompt-caching/messages.ts">PromptCachingBetaTool</a></code>
141-
- <code><a href="./src/resources/beta/prompt-caching/messages.ts">PromptCachingBetaToolResultBlockParam</a></code>
142-
- <code><a href="./src/resources/beta/prompt-caching/messages.ts">PromptCachingBetaToolUseBlockParam</a></code>
143-
- <code><a href="./src/resources/beta/prompt-caching/messages.ts">PromptCachingBetaUsage</a></code>
144-
- <code><a href="./src/resources/beta/prompt-caching/messages.ts">RawPromptCachingBetaMessageStartEvent</a></code>
145-
- <code><a href="./src/resources/beta/prompt-caching/messages.ts">RawPromptCachingBetaMessageStreamEvent</a></code>
146-
147-
Methods:
148-
149-
- <code title="post /v1/messages?beta=prompt_caching">client.beta.promptCaching.messages.<a href="./src/resources/beta/prompt-caching/messages.ts">create</a>({ ...params }) -> PromptCachingBetaMessage</code>
150-
- <code title="post /v1/messages?beta=prompt_caching">client.beta.promptCaching.messages.<a href="./src/resources/beta/prompt-caching/messages.ts">stream</a>({ ...params }) -> PromptCachingBetaMessageStream</code>

examples/count-tokens.ts

Whitespace-only changes.

src/index.ts

Lines changed: 51 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -14,15 +14,35 @@ import {
1414
CompletionCreateParamsStreaming,
1515
Completions,
1616
} from './resources/completions';
17+
import { ModelInfo, ModelInfosPage, ModelListParams, Models } from './resources/models';
1718
import {
19+
AnthropicBeta,
20+
Beta,
21+
BetaAPIError,
22+
BetaAuthenticationError,
23+
BetaBillingError,
24+
BetaError,
25+
BetaErrorResponse,
26+
BetaGatewayTimeoutError,
27+
BetaInvalidRequestError,
28+
BetaNotFoundError,
29+
BetaOverloadedError,
30+
BetaPermissionError,
31+
BetaRateLimitError,
32+
} from './resources/beta/beta';
33+
import {
34+
Base64PDFSource,
35+
CacheControlEphemeral,
1836
ContentBlock,
1937
ContentBlockDeltaEvent,
2038
ContentBlockParam,
2139
ContentBlockStartEvent,
2240
ContentBlockStopEvent,
41+
DocumentBlockParam,
2342
ImageBlockParam,
2443
InputJSONDelta,
2544
Message,
45+
MessageCountTokensParams,
2646
MessageCreateParams,
2747
MessageCreateParamsNonStreaming,
2848
MessageCreateParamsStreaming,
@@ -33,6 +53,7 @@ import {
3353
MessageStopEvent,
3454
MessageStreamEvent,
3555
MessageStreamParams,
56+
MessageTokensCount,
3657
Messages,
3758
Metadata,
3859
Model,
@@ -55,20 +76,7 @@ import {
5576
ToolUseBlock,
5677
ToolUseBlockParam,
5778
Usage,
58-
} from './resources/messages';
59-
import {
60-
AnthropicBeta,
61-
Beta,
62-
BetaAPIError,
63-
BetaAuthenticationError,
64-
BetaError,
65-
BetaErrorResponse,
66-
BetaInvalidRequestError,
67-
BetaNotFoundError,
68-
BetaOverloadedError,
69-
BetaPermissionError,
70-
BetaRateLimitError,
71-
} from './resources/beta/beta';
79+
} from './resources/messages/messages';
7280

7381
export interface ClientOptions {
7482
/**
@@ -202,6 +210,7 @@ export class Anthropic extends Core.APIClient {
202210

203211
completions: API.Completions = new API.Completions(this);
204212
messages: API.Messages = new API.Messages(this);
213+
models: API.Models = new API.Models(this);
205214
beta: API.Beta = new API.Beta(this);
206215

207216
protected override defaultQuery(): Core.DefaultQuery | undefined {
@@ -292,6 +301,8 @@ export class Anthropic extends Core.APIClient {
292301

293302
Anthropic.Completions = Completions;
294303
Anthropic.Messages = Messages;
304+
Anthropic.Models = Models;
305+
Anthropic.ModelInfosPage = ModelInfosPage;
295306
Anthropic.Beta = Beta;
296307
export declare namespace Anthropic {
297308
export type RequestOptions = Core.RequestOptions;
@@ -309,11 +320,14 @@ export declare namespace Anthropic {
309320

310321
export {
311322
Messages as Messages,
323+
type Base64PDFSource as Base64PDFSource,
324+
type CacheControlEphemeral as CacheControlEphemeral,
312325
type ContentBlock as ContentBlock,
313326
type ContentBlockDeltaEvent as ContentBlockDeltaEvent,
314327
type ContentBlockParam as ContentBlockParam,
315328
type ContentBlockStartEvent as ContentBlockStartEvent,
316329
type ContentBlockStopEvent as ContentBlockStopEvent,
330+
type DocumentBlockParam as DocumentBlockParam,
317331
type ImageBlockParam as ImageBlockParam,
318332
type InputJSONDelta as InputJSONDelta,
319333
type Message as Message,
@@ -323,6 +337,7 @@ export declare namespace Anthropic {
323337
type MessageStartEvent as MessageStartEvent,
324338
type MessageStopEvent as MessageStopEvent,
325339
type MessageStreamEvent as MessageStreamEvent,
340+
type MessageTokensCount as MessageTokensCount,
326341
type Metadata as Metadata,
327342
type Model as Model,
328343
type RawContentBlockDeltaEvent as RawContentBlockDeltaEvent,
@@ -348,21 +363,43 @@ export declare namespace Anthropic {
348363
type MessageCreateParamsNonStreaming as MessageCreateParamsNonStreaming,
349364
type MessageCreateParamsStreaming as MessageCreateParamsStreaming,
350365
type MessageStreamParams as MessageStreamParams,
366+
type MessageCountTokensParams as MessageCountTokensParams,
367+
};
368+
369+
export {
370+
Models as Models,
371+
type ModelInfo as ModelInfo,
372+
ModelInfosPage as ModelInfosPage,
373+
type ModelListParams as ModelListParams,
351374
};
352375

353376
export {
354377
Beta as Beta,
355378
type AnthropicBeta as AnthropicBeta,
356379
type BetaAPIError as BetaAPIError,
357380
type BetaAuthenticationError as BetaAuthenticationError,
381+
type BetaBillingError as BetaBillingError,
358382
type BetaError as BetaError,
359383
type BetaErrorResponse as BetaErrorResponse,
384+
type BetaGatewayTimeoutError as BetaGatewayTimeoutError,
360385
type BetaInvalidRequestError as BetaInvalidRequestError,
361386
type BetaNotFoundError as BetaNotFoundError,
362387
type BetaOverloadedError as BetaOverloadedError,
363388
type BetaPermissionError as BetaPermissionError,
364389
type BetaRateLimitError as BetaRateLimitError,
365390
};
391+
392+
export type APIErrorObject = API.APIErrorObject;
393+
export type AuthenticationError = API.AuthenticationError;
394+
export type BillingError = API.BillingError;
395+
export type ErrorObject = API.ErrorObject;
396+
export type ErrorResponse = API.ErrorResponse;
397+
export type GatewayTimeoutError = API.GatewayTimeoutError;
398+
export type InvalidRequestError = API.InvalidRequestError;
399+
export type NotFoundError = API.NotFoundError;
400+
export type OverloadedError = API.OverloadedError;
401+
export type PermissionError = API.PermissionError;
402+
export type RateLimitError = API.RateLimitError;
366403
}
367404
export const { HUMAN_PROMPT, AI_PROMPT } = Anthropic;
368405

0 commit comments

Comments
 (0)