docs(api): update docstrings (#286)

src/resources/chat/completions.ts

@@ -50,7 +50,7 @@ export interface ChatCompletion {
   choices: Array<ChatCompletion.Choice>;
 
   /**
-   * A unix timestamp of when the chat completion was created.
+   * The Unix timestamp (in seconds) of when the chat completion was created.
    */
   created: number;
 
@@ -109,7 +109,7 @@ export interface ChatCompletionChunk {
   choices: Array<ChatCompletionChunk.Choice>;
 
   /**
-   * A unix timestamp of when the chat completion chunk was created.
+   * The Unix timestamp (in seconds) of when the chat completion chunk was created.
    */
   created: number;
 
@@ -321,7 +321,7 @@ export interface ChatCompletionCreateParamsBase {
    * existing frequency in the text so far, decreasing the model's likelihood to
    * repeat the same line verbatim.
    *
-   * [See more information about frequency and presence penalties.](/docs/api-reference/parameter-details)
+   * [See more information about frequency and presence penalties.](/docs/guides/gpt/parameter-details)
    */
   frequency_penalty?: number | null;
 
@@ -372,7 +372,7 @@ export interface ChatCompletionCreateParamsBase {
    * whether they appear in the text so far, increasing the model's likelihood to
    * talk about new topics.
    *
-   * [See more information about frequency and presence penalties.](/docs/api-reference/parameter-details)
+   * [See more information about frequency and presence penalties.](/docs/guides/gpt/parameter-details)
    */
   presence_penalty?: number | null;
 

src/resources/completions.ts

@@ -45,7 +45,7 @@ export interface Completion {
   choices: Array<CompletionChoice>;
 
   /**
-   * The Unix timestamp of when the completion was created.
+   * The Unix timestamp (in seconds) of when the completion was created.
    */
   created: number;
 
@@ -166,7 +166,7 @@ export interface CompletionCreateParamsBase {
    * existing frequency in the text so far, decreasing the model's likelihood to
    * repeat the same line verbatim.
    *
-   * [See more information about frequency and presence penalties.](/docs/api-reference/parameter-details)
+   * [See more information about frequency and presence penalties.](/docs/guides/gpt/parameter-details)
    */
   frequency_penalty?: number | null;
 
@@ -221,7 +221,7 @@ export interface CompletionCreateParamsBase {
    * whether they appear in the text so far, increasing the model's likelihood to
    * talk about new topics.
    *
-   * [See more information about frequency and presence penalties.](/docs/api-reference/parameter-details)
+   * [See more information about frequency and presence penalties.](/docs/guides/gpt/parameter-details)
    */
   presence_penalty?: number | null;
 

src/resources/edits.ts

@@ -25,7 +25,7 @@ export interface Edit {
   choices: Array<Edit.Choice>;
 
   /**
-   * A unix timestamp of when the edit was created.
+   * The Unix timestamp (in seconds) of when the edit was created.
    */
   created: number;
 

src/resources/files.ts

@@ -81,7 +81,7 @@ export interface FileObject {
   bytes: number;
 
   /**
-   * The unix timestamp for when the file was created.
+   * The Unix timestamp (in seconds) for when the file was created.
    */
   created_at: number;
 

src/resources/fine-tunes.ts

@@ -94,7 +94,7 @@ export interface FineTune {
   id: string;
 
   /**
-   * The unix timestamp for when the fine-tuning job was created.
+   * The Unix timestamp (in seconds) for when the fine-tuning job was created.
    */
   created_at: number;
 
@@ -142,7 +142,7 @@ export interface FineTune {
   training_files: Array<Files.FileObject>;
 
   /**
-   * The unix timestamp for when the fine-tuning job was last updated.
+   * The Unix timestamp (in seconds) for when the fine-tuning job was last updated.
    */
   updated_at: number;
 

src/resources/fine-tuning/jobs.ts

@@ -100,7 +100,7 @@ export interface FineTuningJob {
   id: string;
 
   /**
-   * The unix timestamp for when the fine-tuning job was created.
+   * The Unix timestamp (in seconds) for when the fine-tuning job was created.
    */
   created_at: number;
 
@@ -154,10 +154,10 @@ export interface FineTuningJob {
   /**
    * The file ID used for validation.
    */
-  validation_file: string;
+  validation_file: string | null;
 
   /**
-   * The unix timestamp for when the fine-tuning job was finished.
+   * The Unix timestamp (in seconds) for when the fine-tuning job was finished.
    */
   finished_at?: number;
 }

src/resources/models.ts

@@ -23,7 +23,8 @@ export class Models extends APIResource {
   }
 
   /**
-   * Delete a fine-tuned model. You must have the Owner role in your organization.
+   * Delete a fine-tuned model. You must have the Owner role in your organization to
+   * delete a model.
    */
   del(model: string, options?: Core.RequestOptions): Core.APIPromise<ModelDeleted> {
     return this.delete(`/models/${model}`, options);
@@ -47,7 +48,7 @@ export interface Model {
   id: string;
 
   /**
-   * The date and time when the model was created.
+   * The Unix timestamp (in seconds) when the model was created.
    */
   created: number;