feat(api): Add support for image_url in chat user messages

.stats.yml

@@ -1,2 +1,2 @@
 configured_endpoints: 7
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/groqcloud%2Fgroqcloud-a3e82ffbc462174007a5f736784cde91069ac2fd1468c89b0b9faea2fa82580a.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/groqcloud%2Fgroqcloud-4643bbeed7059f8301560a9fa93e4196393cf65a0ce9b243f5bc071efadd2748.yml

api.md

@@ -23,10 +23,6 @@ Methods:
 
 # Audio
 
-Types:
-
-- <code><a href="./src/resources/audio/audio.ts">Translation</a></code>
-
 ## Transcriptions
 
 Types:
@@ -42,6 +38,7 @@ Methods:
 
 Types:
 
+- <code><a href="./src/resources/audio/translations.ts">Translation</a></code>
 - <code><a href="./src/resources/audio/translations.ts">TranslationCreateResponse</a></code>
 
 Methods:

src/index.ts

@@ -67,6 +67,12 @@ export interface ClientOptions {
    * param to `undefined` in request options.
    */
   defaultQuery?: Core.DefaultQuery;
+
+  /**
+   * By default, client-side use of this library is not allowed, as it risks exposing your secret API credentials to attackers.
+   * Only set this option to `true` if you understand the risks and have appropriate mitigations in place.
+   */
+  dangerouslyAllowBrowser?: boolean;
 }
 
 /** API Client for interfacing with the Groq API. */
@@ -86,6 +92,7 @@ export class Groq extends Core.APIClient {
    * @param {number} [opts.maxRetries=2] - The maximum number of times the client will retry a request.
    * @param {Core.Headers} opts.defaultHeaders - Default headers to include with every request to the API.
    * @param {Core.DefaultQuery} opts.defaultQuery - Default query parameters to include with every request to the API.
+   * @param {boolean} [opts.dangerouslyAllowBrowser=false] - By default, client-side use of this library is not allowed, as it risks exposing your secret API credentials to attackers.
    */
   constructor({
     baseURL = Core.readEnv('GROQ_BASE_URL'),
@@ -104,6 +111,12 @@ export class Groq extends Core.APIClient {
       baseURL: baseURL || `https://api.groq.com`,
     };
 
+    if (!options.dangerouslyAllowBrowser && Core.isRunningInBrowser()) {
+      throw new Errors.GroqError(
+        "It looks like you're running in a browser-like environment.\n\nThis is disabled by default, as it risks exposing your secret API credentials to attackers.\nIf you understand the risks and have appropriate mitigations in place,\nyou can set the `dangerouslyAllowBrowser` option to `true`, e.g.,\n\nnew Groq({ apiKey, dangerouslyAllowBrowser: true })",
+      );
+    }
+
     super({
       baseURL: options.baseURL!,
       timeout: options.timeout ?? 60000 /* 1 minute */,
@@ -186,7 +199,6 @@ export namespace Groq {
   export import Chat = API.Chat;
 
   export import Audio = API.Audio;
-  export import Translation = API.Translation;
 
   export import Models = API.Models;
   export import Model = API.Model;

src/resources/audio/audio.ts

@@ -1,7 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../resource';
-import * as AudioAPI from './audio';
 import * as TranscriptionsAPI from './transcriptions';
 import * as TranslationsAPI from './translations';
 
@@ -10,17 +9,13 @@ export class Audio extends APIResource {
   translations: TranslationsAPI.Translations = new TranslationsAPI.Translations(this._client);
 }
 
-export interface Translation {
-  text: string;
-}
-
 export namespace Audio {
-  export import Translation = AudioAPI.Translation;
   export import Transcriptions = TranscriptionsAPI.Transcriptions;
   export import Transcription = TranscriptionsAPI.Transcription;
   export import TranscriptionCreateResponse = TranscriptionsAPI.TranscriptionCreateResponse;
   export import TranscriptionCreateParams = TranscriptionsAPI.TranscriptionCreateParams;
   export import Translations = TranslationsAPI.Translations;
+  export import Translation = TranslationsAPI.Translation;
   export import TranslationCreateResponse = TranslationsAPI.TranslationCreateResponse;
   export import TranslationCreateParams = TranslationsAPI.TranslationCreateParams;
 }

src/resources/audio/index.ts

@@ -1,10 +1,15 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+export { Audio } from './audio';
 export {
   Transcription,
   TranscriptionCreateResponse,
   TranscriptionCreateParams,
   Transcriptions,
 } from './transcriptions';
-export { Translation, Audio } from './audio';
-export { TranslationCreateResponse, TranslationCreateParams, Translations } from './translations';
+export {
+  Translation,
+  TranslationCreateResponse,
+  TranslationCreateParams,
+  Translations,
+} from './translations';

src/resources/audio/translations.ts

@@ -3,7 +3,6 @@
 import * as Core from '../../core';
 import { APIResource } from '../../resource';
 import * as TranslationsAPI from './translations';
-import * as AudioAPI from './audio';
 import { type Uploadable, multipartFormRequestOptions } from '../../core';
 
 export class Translations extends APIResource {
@@ -21,8 +20,12 @@ export class Translations extends APIResource {
   }
 }
 
+export interface Translation {
+  text: string;
+}
+
 export type TranslationCreateResponse =
-  | AudioAPI.Translation
+  | Translation
   | TranslationCreateResponse.CreateTranslationResponseVerboseJson;
 
 export namespace TranslationCreateResponse {
@@ -142,6 +145,7 @@ export interface TranslationCreateParams {
 }
 
 export namespace Translations {
+  export import Translation = TranslationsAPI.Translation;
   export import TranslationCreateResponse = TranslationsAPI.TranslationCreateResponse;
   export import TranslationCreateParams = TranslationsAPI.TranslationCreateParams;
 }

src/resources/chat/completions.ts

@@ -155,7 +155,12 @@ export interface CompletionCreateParams {
 
 export namespace CompletionCreateParams {
   export interface Message {
-    content: string;
+    content:
+      | string
+      | Array<
+          | Message.TypesChatCompletionRequestMessageContentPartText
+          | Message.TypesChatCompletionRequestMessageContentPartImage
+        >;
 
     role: string;
 
@@ -173,6 +178,41 @@ export namespace CompletionCreateParams {
   }
 
   export namespace Message {
+    export interface TypesChatCompletionRequestMessageContentPartText {
+      /**
+       * The text content.
+       */
+      text: string;
+
+      /**
+       * The type of the content part.
+       */
+      type: 'text';
+    }
+
+    export interface TypesChatCompletionRequestMessageContentPartImage {
+      image_url: TypesChatCompletionRequestMessageContentPartImage.ImageURL;
+
+      /**
+       * The type of the content part.
+       */
+      type: 'image_url';
+    }
+
+    export namespace TypesChatCompletionRequestMessageContentPartImage {
+      export interface ImageURL {
+        /**
+         * Either a URL of the image or the base64 encoded image data.
+         */
+        url: string;
+
+        /**
+         * Specifies the detail level of the image.
+         */
+        detail?: 'auto' | 'low' | 'high';
+      }
+    }
+
     export interface ToolCall {
       id?: string;
 

src/resources/index.ts

@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+export { Audio } from './audio/audio';
 export { Chat } from './chat/chat';
 export { CreateEmbeddingResponse, Embedding, EmbeddingCreateParams, Embeddings } from './embeddings';
 export { Model, ModelList, Models } from './models';
-export { Translation, Audio } from './audio/audio';