@j-o-r/hello-dave 0.0.10 → 0.1.0

package/lib/API/minimax/image.to.image.md

@@ -0,0 +1,257 @@
+> ## Documentation Index
+> Fetch the complete documentation index at: https://platform.minimax.io/docs/llms.txt
+> Use this file to discover all available pages before exploring further.
+
+# Image-to-Image Generation
+
+> Use this API to generate images from image input.
+
+
+
+## OpenAPI
+
+````yaml /api-reference/image/generation/api/image-to-image.json POST /v1/image_generation
+openapi: 3.1.0
+info:
+  title: MiniMax Image Generation API
+  description: MiniMax image generation API for creating images from text prompts
+  license:
+    name: MIT
+  version: 1.0.0
+servers:
+  - url: https://api.minimax.io
+security:
+  - bearerAuth: []
+paths:
+  /v1/image_generation:
+    post:
+      tags:
+        - Image
+      summary: Image Generation
+      operationId: imageGeneration
+      parameters:
+        - name: Content-Type
+          in: header
+          required: true
+          description: >-
+            The media type of the request body. Must be set to
+            `application/json` to ensure the data is sent in JSON format.
+          schema:
+            type: string
+            enum:
+              - application/json
+            default: application/json
+      requestBody:
+        description: ''
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/ImageGenerationReq'
+        required: true
+      responses:
+        '200':
+          description: ''
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ImageGenerationResp'
+components:
+  schemas:
+    ImageGenerationReq:
+      type: object
+      required:
+        - prompt
+        - model
+      properties:
+        model:
+          type: string
+          description: 'Model name. Options: `image-01`.'
+          enum:
+            - image-01
+            - image-01-live
+        prompt:
+          type: string
+          description: Text description of the image, max length 1500 characters.
+        subject_reference:
+          type: array
+          items:
+            $ref: '#/components/schemas/ImageSubjectReference'
+          description: Subject reference for image-to-image generation.
+        aspect_ratio:
+          type: string
+          description: |-
+            Image aspect ratio, default `1:1`. Options:
+            - `1:1` (1024x1024)
+            - `16:9` (1280x720)
+            - `4:3` (1152x864)
+            - `3:2` (1248x832)
+            - `2:3` (832x1248)
+            - `3:4` (864x1152)
+            - `9:16` (720x1280)
+            - `21:9` (1344x576)
+          enum:
+            - '1:1'
+            - '16:9'
+            - '4:3'
+            - '3:2'
+            - '2:3'
+            - '3:4'
+            - '9:16'
+            - '21:9'
+        width:
+          type: integer
+          description: >-
+            Image width (px). Only effective for `image-01`. Must be set
+            together with `height`. Range [512, 2048], must be divisible by 8.
+            If both `width/height` and `aspect_ratio` are provided,
+            `aspect_ratio` takes priority.
+        height:
+          type: integer
+          description: >-
+            Height of generated image (pixels). Only effective when `model` is
+            `image-01`.
+
+            Same rules as `width`.
+        response_format:
+          type: string
+          enum:
+            - url
+            - base64
+          default: url
+          description: |-
+            Response format for images. Default: url. Options: url, base64.
+            ⚠️ Note: url expires in 24 hours.
+        seed:
+          type: integer
+          format: int64
+          description: >-
+            Random seed. Using the same seed and parameters allows result
+            reproduction.
+
+            If omitted, each of the n images will use a unique random seed.
+        'n':
+          type: integer
+          default: 1
+          minimum: 1
+          maximum: 9
+          description: 'Number of images to generate per request. Range [1, 9]. Default: 1.'
+        prompt_optimizer:
+          type: boolean
+          default: false
+          description: 'Enable automatic optimization of prompt. Default: `false`.'
+      example:
+        model: image-01
+        prompt: A girl looking into the distance from a library window
+        aspect_ratio: '16:9'
+        subject_reference:
+          - type: character
+            image_file: >-
+              https://cdn.hailuoai.com/prod/2025-08-12-17/video_cover/1754990600020238321-411603868533342214-cover.jpg
+        'n': 2
+    ImageGenerationResp:
+      type: object
+      properties:
+        data:
+          $ref: '#/components/schemas/DataObject'
+        metadata:
+          type: object
+          properties:
+            success_count:
+              type: integer
+              description: Number of successfully generated images.
+            failed_count:
+              type: integer
+              description: Number of images blocked due to content safety.
+          description: Additional metadata about the generation.
+        id:
+          type: string
+          description: Trace ID for request tracking
+        base_resp:
+          $ref: '#/components/schemas/BaseResp'
+      example:
+        id: 03ff3cd0820949eb8a410056b5f21d38
+        data:
+          image_urls:
+            - XXX
+            - XXX
+            - XXX
+        metadata:
+          failed_count: '0'
+          success_count: '3'
+        base_resp:
+          status_code: 0
+          status_msg: success
+    ImageSubjectReference:
+      type: object
+      required:
+        - type
+        - image_file
+      properties:
+        type:
+          type: string
+          description: Subject type. Currently only supports `character` (portrait).
+        image_file:
+          type: string
+          description: "Reference image file. Supports public URLs or Base64-encoded [Data URL](https://developer.mozilla.org/en-US/docs/Web/URI/Reference/Schemes/data) (`data:image/jpeg;base64,...`).\nFor best results, upload a single front-facing portrait photo.\n- Image requirements:\n\t- Formats: JPG, JPEG, PNG\n\t- Size: less than 10MB"
+    DataObject:
+      type: object
+      properties:
+        image_urls:
+          type: array
+          items:
+            type: string
+          description: >-
+            Returned when `response_format` = `url`, contains an array of image
+            links.
+        image_base64:
+          type: array
+          items:
+            type: string
+          description: >-
+            Returned when `response_format` = `base64`, contains an array of
+            base64-encoded images.
+    BaseResp:
+      type: object
+      properties:
+        status_code:
+          type: integer
+          description: >-
+            The status codes and their meanings are as follows:
+
+            - `0`, Request successful
+
+            - `1002`, Rate limit triggered, please try again later
+
+            - `1004`, Account authentication failed, please check if the API Key
+            is correct
+
+            - `1008`, Insufficient account balance
+
+            - `1026`, Sensitive content detected in prompt
+
+            - `2013`, Invalid input parameters, please check if the parameters
+            are filled in as required
+
+            - `2049`, Invalid API key
+
+
+            For more information, please refer to the [Error Code
+            Reference](/api-reference/errorcode).  
+        status_msg:
+          type: string
+          description: Status details.
+  securitySchemes:
+    bearerAuth:
+      type: http
+      scheme: bearer
+      bearerFormat: JWT
+      description: >-
+        `HTTP: Bearer Auth`
+
+        - Security Scheme Type: http
+
+        - HTTP Authorization Scheme: `Bearer API_key`, can be found in [Account
+        Management>API
+        Keys](https://platform.minimax.io/user-center/basic-information/interface-key).
+
+````

package/lib/API/minimax/index.js

@@ -0,0 +1,16 @@
+import * as music from './music.js';
+import * as image from './image.js';
+import * as video from './video.js';
+
+import musicToolset from './MusicToolset.js'
+import videoToolset from './VideoToolset.js'
+import imageToolset from './ImageToolset.js'
+
+export default {
+	music,
+	musicToolset,
+	video,
+	videoToolset,
+	image,
+	imageToolset
+}

package/lib/API/minimax/music.cover.preprocess.md

@@ -0,0 +1,206 @@
+> ## Documentation Index
+> Fetch the complete documentation index at: https://platform.minimax.io/docs/llms.txt
+> Use this file to discover all available pages before exploring further.
+
+# Music Cover Preprocess
+
+> Preprocess reference audio to extract features and lyrics for two-step cover generation.
+
+
+
+## OpenAPI
+
+````yaml POST /v1/music_cover_preprocess
+openapi: 3.1.0
+info:
+  title: MiniMax Music Generation API
+  description: >-
+    MiniMax music generation API with support for creating music from text
+    prompts and lyrics
+  license:
+    name: MIT
+  version: 1.0.0
+servers:
+  - url: https://api.minimax.io
+security:
+  - bearerAuth: []
+paths:
+  /v1/music_cover_preprocess:
+    post:
+      tags:
+        - Music
+      summary: Music Cover Preprocess
+      operationId: coverPreprocess
+      parameters:
+        - name: Content-Type
+          in: header
+          required: true
+          description: >-
+            The media type of the request body. Must be set to
+            `application/json` to ensure the data is sent in JSON format.
+          schema:
+            type: string
+            enum:
+              - application/json
+            default: application/json
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/CoverPreprocessReq'
+        required: true
+      responses:
+        '200':
+          description: ''
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/CoverPreprocessResp'
+components:
+  schemas:
+    CoverPreprocessReq:
+      type: object
+      required:
+        - model
+      properties:
+        model:
+          type: string
+          description: Model name. Must be `music-cover`.
+          enum:
+            - music-cover
+        audio_url:
+          type: string
+          description: >-
+            URL of the reference audio. Exactly one of `audio_url` or
+            `audio_base64` must be provided.
+
+
+            Reference audio constraints:
+
+            - Duration: 6 seconds to 6 minutes
+
+            - Size: max 50 MB
+
+            - Format: common audio formats (mp3, wav, flac, etc.)
+        audio_base64:
+          type: string
+          description: >-
+            Base64-encoded reference audio. Exactly one of `audio_url` or
+            `audio_base64` must be provided.
+
+
+            Reference audio constraints:
+
+            - Duration: 6 seconds to 6 minutes
+
+            - Size: max 50 MB
+
+            - Format: common audio formats (mp3, wav, flac, etc.)
+      example:
+        model: music-cover
+        audio_url: https://example.com/song.mp3
+    CoverPreprocessResp:
+      type: object
+      properties:
+        cover_feature_id:
+          type: string
+          description: >-
+            Unique identifier for the preprocessed audio features. Valid for 24
+            hours. Pass this to the [Music Generation
+            API](/api-reference/music-generation) `cover_feature_id` parameter
+            for two-step cover generation.
+
+
+            Same audio content returns the same `cover_feature_id` (MD5-based
+            deduplication).
+        formatted_lyrics:
+          type: string
+          description: >-
+            Structured lyrics extracted from the reference audio via ASR,
+            formatted with section tags such as `[Verse]`, `[Chorus]`,
+            `[Bridge]`, etc. You can modify these lyrics before passing them to
+            the Music Generation API.
+        structure_result:
+          type: string
+          description: >-
+            JSON string containing the song structure analysis result, including
+            segment types (`intro`, `verse`, `chorus`, `bridge`, `outro`,
+            `inst`, `silence`) and their start/end timestamps in seconds.
+        audio_duration:
+          type: number
+          format: double
+          description: Duration of the reference audio in seconds.
+        trace_id:
+          type: string
+          description: Unique trace ID for request tracking.
+        base_resp:
+          $ref: '#/components/schemas/BaseResp'
+      example:
+        cover_feature_id: a1b2c3d4e5f67890abcdef1234567890
+        formatted_lyrics: |-
+          [Verse 1]
+          First line of the song
+          Second line continues
+
+          [Chorus]
+          This is the chorus
+          Singing out loud
+        structure_result: >-
+          {"num_segments":4,"segments":[{"start":0,"end":15.5,"label":"intro"},{"start":15.5,"end":45.2,"label":"verse"},{"start":45.2,"end":75.0,"label":"chorus"},{"start":75.0,"end":90.0,"label":"outro"}]}
+        audio_duration: 90
+        trace_id: 061e5f144eb7f10b1fdde81126e24f91
+        base_resp:
+          status_code: 0
+          status_msg: success
+    BaseResp:
+      type: object
+      description: Status code and details
+      properties:
+        status_code:
+          type: integer
+          description: >-
+            Status codes and their meanings:
+
+
+            `0`: Success
+
+
+            `1002`: Rate limit triggered, retry later
+
+
+            `1004`: Authentication failed, check API key
+
+
+            `1008`: Insufficient balance
+
+
+            `1026`: Content flagged for sensitive material
+
+
+            `2013`: Invalid parameters, check input
+
+
+            `2049`: Invalid API key
+
+
+            For more information, please refer to the [Error Code
+            Reference](/api-reference/errorcode).
+        status_msg:
+          type: string
+          description: Detailed error message
+  securitySchemes:
+    bearerAuth:
+      type: http
+      scheme: bearer
+      bearerFormat: JWT
+      description: >-
+        `HTTP: Bearer Auth`
+
+        - Security Scheme Type: http
+
+        - HTTP Authorization Scheme: `Bearer API_key`, can be found in [Account
+        Management>API
+        Keys](https://platform.minimax.io/user-center/basic-information/interface-key).
+
+````
+