feat(api): Support API key expiration metadata (#984)

## Summary

Add optional expiration controls and metadata for project service
account API keys. Refresh SDK documentation links to the current
developer guides and API reference.

## Changes

- Add `expiresInSeconds` to service account creation parameters to
configure the initial API key lifetime, subject to organization and
project policies.
- Expose optional `expiresAt` timestamps on project API keys and API
keys returned when creating service accounts.
- Update public API documentation links across models and services to
their current destinations.

Co-authored-by: apcha-oai <228803254+apcha-oai@users.noreply.github.com>

Author: apcha-oai

.castiron.stats.yml

@@ -1,8 +1,8 @@
 schema_version: 1
-generation_id: d231f6bf-7ba6-4566-a3b5-1594927f874c
-openapi_spec_hash: 0ac5ea4ab2546a188a36a0d370367637
-openapi_transformed_spec_hash: 6be6c39576ec27111cab26c251d2ab65
-config_hash: d92ec885ac2a08b6a4c1ff90420f0327
-codegen_sha: 6b5c1351630844386f6789b2ad525184ae291fcd
-codegen_hash: 3590be3fb9d4224b65931fe65334f9aa18348e99332770511100daae78422f50
-public_codegen_sha: 6e84784e4881104d2d9258eee1cd00f2faabda90
+generation_id: d212b3b0-c819-4283-818c-233044a43e3b
+openapi_spec_hash: cc8bc0e9cda20d98cbcab338ff08b50c
+openapi_transformed_spec_hash: 2f1cea3510c46bd2b681baf83d8724c5
+config_hash: d7b82262337a543ff59106e4a32ead4e
+codegen_sha: cb40ff162564d49e9a0a4c9ab42cde61c132804c
+codegen_hash: c8abce62abb861e7f4eee4ef1bef89324d5506b9d7a2933b8f05f350d1f59aaa
+public_codegen_sha: aae628a308ef202b897af61e6695e4fe3f7d2672

api_reference/openapi.transformed.yml

@@ -59,7 +59,7 @@ private constructor(
 
     /**
      * The parameters the functions accepts, described as a JSON Schema object. See the
-     * [guide](https://platform.openai.com/docs/guides/function-calling) for examples, and the
+     * [guide](https://developers.openai.com/api/docs/guides/function-calling) for examples, and the
      * [JSON Schema reference](https://json-schema.org/understanding-json-schema/) for documentation
      * about the format.
      *
@@ -74,7 +74,7 @@ private constructor(
      * Whether to enable strict schema adherence when generating the function call. If set to true,
      * the model will follow the exact schema defined in the `parameters` field. Only a subset of
      * JSON Schema is supported when `strict` is `true`. Learn more about Structured Outputs in the
-     * [function calling guide](https://platform.openai.com/docs/guides/function-calling).
+     * [function calling guide](https://developers.openai.com/api/docs/guides/function-calling).
      *
      * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
@@ -185,8 +185,8 @@ private constructor(
 
         /**
          * The parameters the functions accepts, described as a JSON Schema object. See the
-         * [guide](https://platform.openai.com/docs/guides/function-calling) for examples, and the
-         * [JSON Schema reference](https://json-schema.org/understanding-json-schema/) for
+         * [guide](https://developers.openai.com/api/docs/guides/function-calling) for examples, and
+         * the [JSON Schema reference](https://json-schema.org/understanding-json-schema/) for
          * documentation about the format.
          *
          * Omitting `parameters` defines a function with an empty parameter list.
@@ -209,7 +209,7 @@ private constructor(
          * true, the model will follow the exact schema defined in the `parameters` field. Only a
          * subset of JSON Schema is supported when `strict` is `true`. Learn more about Structured
          * Outputs in the
-         * [function calling guide](https://platform.openai.com/docs/guides/function-calling).
+         * [function calling guide](https://developers.openai.com/api/docs/guides/function-calling).
          */
         fun strict(strict: Boolean?) = strict(JsonField.ofNullable(strict))
 

openai-java-core/src/main/kotlin/com/openai/models/FunctionDefinition.kt

@@ -12,7 +12,7 @@ import java.util.Objects
 
 /**
  * The parameters the functions accepts, described as a JSON Schema object. See the
- * [guide](https://platform.openai.com/docs/guides/function-calling) for examples, and the
+ * [guide](https://developers.openai.com/api/docs/guides/function-calling) for examples, and the
  * [JSON Schema reference](https://json-schema.org/understanding-json-schema/) for documentation
  * about the format.
  *

openai-java-core/src/main/kotlin/com/openai/models/FunctionParameters.kt

@@ -18,7 +18,8 @@ import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
 /**
- * Configuration options for [reasoning models](https://platform.openai.com/docs/guides/reasoning).
+ * Configuration options for
+ * [reasoning models](https://developers.openai.com/api/docs/guides/reasoning).
  */
 class Reasoning
 @JsonCreator(mode = JsonCreator.Mode.DISABLED)
@@ -62,7 +63,7 @@ private constructor(
      * `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning effort can result
      * in faster responses and fewer tokens used on reasoning in a response. Not all reasoning
      * models support every value. See the
-     * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for model-specific
+     * [reasoning guide](https://developers.openai.com/api/docs/guides/reasoning) for model-specific
      * support.
      *
      * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
@@ -207,8 +208,8 @@ private constructor(
          * `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning effort
          * can result in faster responses and fewer tokens used on reasoning in a response. Not all
          * reasoning models support every value. See the
-         * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for model-specific
-         * support.
+         * [reasoning guide](https://developers.openai.com/api/docs/guides/reasoning) for
+         * model-specific support.
          */
         fun effort(effort: ReasoningEffort?) = effort(JsonField.ofNullable(effort))
 

openai-java-core/src/main/kotlin/com/openai/models/Reasoning.kt

@@ -11,8 +11,9 @@ import com.openai.errors.OpenAIInvalidDataException
  * Constrains effort on reasoning for reasoning models. Currently supported values are `none`,
  * `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning effort can result in
  * faster responses and fewer tokens used on reasoning in a response. Not all reasoning models
- * support every value. See the [reasoning guide](https://platform.openai.com/docs/guides/reasoning)
- * for model-specific support.
+ * support every value. See the
+ * [reasoning guide](https://developers.openai.com/api/docs/guides/reasoning) for model-specific
+ * support.
  */
 class ReasoningEffort @JsonCreator private constructor(private val value: JsonField<String>) :
     Enum {

openai-java-core/src/main/kotlin/com/openai/models/ReasoningEffort.kt

@@ -20,7 +20,7 @@ import kotlin.jvm.optionals.getOrNull
 
 /**
  * JSON Schema response format. Used to generate structured JSON responses. Learn more about
- * [Structured Outputs](https://platform.openai.com/docs/guides/structured-outputs).
+ * [Structured Outputs](https://developers.openai.com/api/docs/guides/structured-outputs).
  */
 class ResponseFormatJsonSchema
 @JsonCreator(mode = JsonCreator.Mode.DISABLED)
@@ -266,7 +266,7 @@ private constructor(
          * Whether to enable strict schema adherence when generating the output. If set to true, the
          * model will always follow the exact schema defined in the `schema` field. Only a subset of
          * JSON Schema is supported when `strict` is `true`. To learn more, read the
-         * [Structured Outputs guide](https://platform.openai.com/docs/guides/structured-outputs).
+         * [Structured Outputs guide](https://developers.openai.com/api/docs/guides/structured-outputs).
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
@@ -397,7 +397,7 @@ private constructor(
              * Whether to enable strict schema adherence when generating the output. If set to true,
              * the model will always follow the exact schema defined in the `schema` field. Only a
              * subset of JSON Schema is supported when `strict` is `true`. To learn more, read the
-             * [Structured Outputs guide](https://platform.openai.com/docs/guides/structured-outputs).
+             * [Structured Outputs guide](https://developers.openai.com/api/docs/guides/structured-outputs).
              */
             fun strict(strict: Boolean?) = strict(JsonField.ofNullable(strict))
 

openai-java-core/src/main/kotlin/com/openai/models/ResponseFormatJsonSchema.kt

@@ -17,7 +17,7 @@ import java.util.Objects
 
 /**
  * A custom grammar for the model to follow when generating text. Learn more in the
- * [custom grammars guide](https://platform.openai.com/docs/guides/custom-grammars).
+ * [custom grammars guide](https://developers.openai.com/api/docs/guides/function-calling#context-free-grammars).
  */
 class ResponseFormatTextGrammar
 @JsonCreator(mode = JsonCreator.Mode.DISABLED)

openai-java-core/src/main/kotlin/com/openai/models/ResponseFormatTextGrammar.kt

@@ -15,8 +15,8 @@ import java.util.Objects
 
 /**
  * Configure the model to generate valid Python code. See the
- * [custom grammars guide](https://platform.openai.com/docs/guides/custom-grammars) for more
- * details.
+ * [custom grammars guide](https://developers.openai.com/api/docs/guides/function-calling#context-free-grammars)
+ * for more details.
  */
 class ResponseFormatTextPython
 @JsonCreator(mode = JsonCreator.Mode.DISABLED)

openai-java-core/src/main/kotlin/com/openai/models/ResponseFormatTextPython.kt

@@ -60,7 +60,7 @@ private constructor(
     /**
      * Return only events with a `type` in one of these values. For example, `project.created`. For
      * all options, see the documentation for the
-     * [audit log object](https://platform.openai.com/docs/api-reference/audit-logs/object).
+     * [audit log object](https://developers.openai.com/api/reference/resources/admin/subresources/organization/subresources/audit_logs).
      */
     fun eventTypes(): Optional<List<EventType>> = Optional.ofNullable(eventTypes)
 
@@ -201,7 +201,7 @@ private constructor(
         /**
          * Return only events with a `type` in one of these values. For example, `project.created`.
          * For all options, see the documentation for the
-         * [audit log object](https://platform.openai.com/docs/api-reference/audit-logs/object).
+         * [audit log object](https://developers.openai.com/api/reference/resources/admin/subresources/organization/subresources/audit_logs).
          */
         fun eventTypes(eventTypes: List<EventType>?) = apply {
             this.eventTypes = eventTypes?.toMutableList()