feat(api): add support for speed mode

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 34
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/anthropic%2Fanthropic-267f913f89364cb8df3a758335a974b43eb98019a8ceef0a9b0a94ef34c2a3b5.yml
-openapi_spec_hash: aa708f3d3bc54992526cbf5894427446
-config_hash: d56fbaeeb3934b1a3b374590c9837ddd
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/anthropic%2Fanthropic-fee5dc365a4948e68639582c5301d4d0666c7d85a11628d7917e1477f76d3da1.yml
+openapi_spec_hash: d5543958074cd2bd74096cd69f3bb4f9
+config_hash: c4802b6c7f8ffae62f7d73b2ac61e635

anthropic-java-core/src/main/kotlin/com/anthropic/models/beta/AnthropicBeta.kt

@@ -60,6 +60,8 @@ class AnthropicBeta @JsonCreator private constructor(private val value: JsonFiel
 
         @JvmField val SKILLS_2025_10_02 = of("skills-2025-10-02")
 
+        @JvmField val FAST_MODE_2026_02_01 = of("fast-mode-2026-02-01")
+
         @JvmStatic fun of(value: String) = AnthropicBeta(JsonField.of(value))
     }
 
@@ -84,6 +86,7 @@ class AnthropicBeta @JsonCreator private constructor(private val value: JsonFiel
         CONTEXT_MANAGEMENT_2025_06_27,
         MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26,
         SKILLS_2025_10_02,
+        FAST_MODE_2026_02_01,
     }
 
     /**
@@ -115,6 +118,7 @@ class AnthropicBeta @JsonCreator private constructor(private val value: JsonFiel
         CONTEXT_MANAGEMENT_2025_06_27,
         MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26,
         SKILLS_2025_10_02,
+        FAST_MODE_2026_02_01,
         /**
          * An enum member indicating that [AnthropicBeta] was instantiated with an unknown value.
          */
@@ -150,6 +154,7 @@ class AnthropicBeta @JsonCreator private constructor(private val value: JsonFiel
             MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26 ->
                 Value.MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26
             SKILLS_2025_10_02 -> Value.SKILLS_2025_10_02
+            FAST_MODE_2026_02_01 -> Value.FAST_MODE_2026_02_01
             else -> Value._UNKNOWN
         }
 
@@ -183,6 +188,7 @@ class AnthropicBeta @JsonCreator private constructor(private val value: JsonFiel
             MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26 ->
                 Known.MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26
             SKILLS_2025_10_02 -> Known.SKILLS_2025_10_02
+            FAST_MODE_2026_02_01 -> Known.FAST_MODE_2026_02_01
             else -> throw AnthropicInvalidDataException("Unknown AnthropicBeta: $value")
         }
 

anthropic-java-core/src/main/kotlin/com/anthropic/models/beta/messages/BetaUsage.kt

@@ -43,6 +43,7 @@ private constructor(
     private val outputTokens: JsonField<Long>,
     private val serverToolUse: JsonField<BetaServerToolUsage>,
     private val serviceTier: JsonField<ServiceTier>,
+    private val speed: JsonField<Speed>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
 
@@ -75,6 +76,7 @@ private constructor(
         @JsonProperty("service_tier")
         @ExcludeMissing
         serviceTier: JsonField<ServiceTier> = JsonMissing.of(),
+        @JsonProperty("speed") @ExcludeMissing speed: JsonField<Speed> = JsonMissing.of(),
     ) : this(
         cacheCreation,
         cacheCreationInputTokens,
@@ -85,6 +87,7 @@ private constructor(
         outputTokens,
         serverToolUse,
         serviceTier,
+        speed,
         mutableMapOf(),
     )
 
@@ -170,6 +173,14 @@ private constructor(
      */
     fun serviceTier(): Optional<ServiceTier> = serviceTier.getOptional("service_tier")
 
+    /**
+     * The inference speed mode used for this request.
+     *
+     * @throws AnthropicInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun speed(): Optional<Speed> = speed.getOptional("speed")
+
     /**
      * Returns the raw JSON value of [cacheCreation].
      *
@@ -251,6 +262,13 @@ private constructor(
     @ExcludeMissing
     fun _serviceTier(): JsonField<ServiceTier> = serviceTier
 
+    /**
+     * Returns the raw JSON value of [speed].
+     *
+     * Unlike [speed], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("speed") @ExcludeMissing fun _speed(): JsonField<Speed> = speed
+
     @JsonAnySetter
     private fun putAdditionalProperty(key: String, value: JsonValue) {
         additionalProperties.put(key, value)
@@ -279,6 +297,7 @@ private constructor(
          * .outputTokens()
          * .serverToolUse()
          * .serviceTier()
+         * .speed()
          * ```
          */
         @JvmStatic fun builder() = Builder()
@@ -296,6 +315,7 @@ private constructor(
         private var outputTokens: JsonField<Long>? = null
         private var serverToolUse: JsonField<BetaServerToolUsage>? = null
         private var serviceTier: JsonField<ServiceTier>? = null
+        private var speed: JsonField<Speed>? = null
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
         @JvmSynthetic
@@ -309,6 +329,7 @@ private constructor(
             outputTokens = betaUsage.outputTokens
             serverToolUse = betaUsage.serverToolUse
             serviceTier = betaUsage.serviceTier
+            speed = betaUsage.speed
             additionalProperties = betaUsage.additionalProperties.toMutableMap()
         }
 
@@ -523,6 +544,20 @@ private constructor(
             this.serviceTier = serviceTier
         }
 
+        /** The inference speed mode used for this request. */
+        fun speed(speed: Speed?) = speed(JsonField.ofNullable(speed))
+
+        /** Alias for calling [Builder.speed] with `speed.orElse(null)`. */
+        fun speed(speed: Optional<Speed>) = speed(speed.getOrNull())
+
+        /**
+         * Sets [Builder.speed] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.speed] with a well-typed [Speed] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun speed(speed: JsonField<Speed>) = apply { this.speed = speed }
+
         fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
             this.additionalProperties.clear()
             putAllAdditionalProperties(additionalProperties)
@@ -558,6 +593,7 @@ private constructor(
          * .outputTokens()
          * .serverToolUse()
          * .serviceTier()
+         * .speed()
          * ```
          *
          * @throws IllegalStateException if any required field is unset.
@@ -573,6 +609,7 @@ private constructor(
                 checkRequired("outputTokens", outputTokens),
                 checkRequired("serverToolUse", serverToolUse),
                 checkRequired("serviceTier", serviceTier),
+                checkRequired("speed", speed),
                 additionalProperties.toMutableMap(),
             )
     }
@@ -593,6 +630,7 @@ private constructor(
         outputTokens()
         serverToolUse().ifPresent { it.validate() }
         serviceTier().ifPresent { it.validate() }
+        speed().ifPresent { it.validate() }
         validated = true
     }
 
@@ -619,7 +657,8 @@ private constructor(
             (iterations.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
             (if (outputTokens.asKnown().isPresent) 1 else 0) +
             (serverToolUse.asKnown().getOrNull()?.validity() ?: 0) +
-            (serviceTier.asKnown().getOrNull()?.validity() ?: 0)
+            (serviceTier.asKnown().getOrNull()?.validity() ?: 0) +
+            (speed.asKnown().getOrNull()?.validity() ?: 0)
 
     /** Token usage for a sampling iteration. */
     @JsonDeserialize(using = BetaIterationsUsageItems.Deserializer::class)
@@ -973,6 +1012,134 @@ private constructor(
         override fun toString() = value.toString()
     }
 
+    /** The inference speed mode used for this request. */
+    class Speed @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val STANDARD = of("standard")
+
+            @JvmField val FAST = of("fast")
+
+            @JvmStatic fun of(value: String) = Speed(JsonField.of(value))
+        }
+
+        /** An enum containing [Speed]'s known values. */
+        enum class Known {
+            STANDARD,
+            FAST,
+        }
+
+        /**
+         * An enum containing [Speed]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Speed] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            STANDARD,
+            FAST,
+            /** An enum member indicating that [Speed] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                STANDARD -> Value.STANDARD
+                FAST -> Value.FAST
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws AnthropicInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                STANDARD -> Known.STANDARD
+                FAST -> Known.FAST
+                else -> throw AnthropicInvalidDataException("Unknown Speed: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws AnthropicInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow {
+                AnthropicInvalidDataException("Value is not a String")
+            }
+
+        private var validated: Boolean = false
+
+        fun validate(): Speed = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: AnthropicInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Speed && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
     override fun equals(other: Any?): Boolean {
         if (this === other) {
             return true
@@ -988,6 +1155,7 @@ private constructor(
             outputTokens == other.outputTokens &&
             serverToolUse == other.serverToolUse &&
             serviceTier == other.serviceTier &&
+            speed == other.speed &&
             additionalProperties == other.additionalProperties
     }
 
@@ -1002,12 +1170,13 @@ private constructor(
             outputTokens,
             serverToolUse,
             serviceTier,
+            speed,
             additionalProperties,
         )
     }
 
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "BetaUsage{cacheCreation=$cacheCreation, cacheCreationInputTokens=$cacheCreationInputTokens, cacheReadInputTokens=$cacheReadInputTokens, inferenceGeo=$inferenceGeo, inputTokens=$inputTokens, iterations=$iterations, outputTokens=$outputTokens, serverToolUse=$serverToolUse, serviceTier=$serviceTier, additionalProperties=$additionalProperties}"
+        "BetaUsage{cacheCreation=$cacheCreation, cacheCreationInputTokens=$cacheCreationInputTokens, cacheReadInputTokens=$cacheReadInputTokens, inferenceGeo=$inferenceGeo, inputTokens=$inputTokens, iterations=$iterations, outputTokens=$outputTokens, serverToolUse=$serverToolUse, serviceTier=$serviceTier, speed=$speed, additionalProperties=$additionalProperties}"
 }