# "/fal-ai/nano-banana Tạo ảnh từ văn bản"

Nguồn: https://docs.openaihub.net/api-45208897/

> API origin: `https://api.openaihub.net`. Chọn đúng nhóm API và model. Thông số dưới đây là bản tham chiếu kỹ thuật; chưa phải kết quả kiểm thử từng endpoint bằng tài khoản của bạn.


## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /fal-ai/nano-banana:
    post:
      summary: /fal-ai/nano-banana Tạo ảnh từ văn bản
      deprecated: false
      description: 'Tài liệu chính thức: https://fal.ai/models/fal-ai/nano-banana'
      operationId: fal_ai_fal_ai_nano_banana
      tags:
        - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Fal.ai
        - Fal.ai
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - prompt
              properties:
                num_images:
                  type: integer
                  description: >-
                    Số lượng hình ảnh được tạo. Phạm vi giá trị: 1-4. Giá trị
                    mặc định: 1
                prompt:
                  type: string
                  description: Tạo các từ gợi ý cho hình ảnh.
              refName: PostFalAiNanoBananaRequest
              x-apifox-orders:
                - num_images
                - prompt
              x-apidog-orders:
                - num_images
                - prompt
            examples:
              fal_ainano_banana_single:
                value:
                  num_images: 1
                  prompt: >-
                    Cảnh hành động chụp một chú chó Labrador đen đang bơi trong
                    hồ bơi âm đất ở khu ngoại ô. Máy ảnh được đặt chính xác trên
                    mặt nước, chia đôi hình ảnh, cho thấy cả đầu chú chó nhô lên
                    khỏi mặt nước với một quả bóng tennis ngậm trong miệng, lẫn
                    những bàn chân đang quẫy dưới nước.
                summary: fal_ainano_banana_single
                description: /fal-ai/nano-banana Tạo ảnh từ văn bản
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                required:
                  - status
                  - request_id
                  - response_url
                  - status_url
                  - cancel_url
                  - logs
                  - metrics
                  - queue_position
                properties:
                  cancel_url:
                    type: string
                    description: URL hủy tác vụ
                  logs:
                    type: array
                    items:
                      type: string
                    description: Nhật ký chạy
                    nullable: true
                  metrics:
                    type: object
                    description: Số liệu chạy
                    x-apidog-orders: []
                  queue_position:
                    type: integer
                    description: Vị trí trong hàng đợi
                  request_id:
                    type: string
                    description: ID truy vết yêu cầu
                  response_url:
                    type: string
                    description: URL truy vấn kết quả
                  status:
                    type: string
                    description: Trạng thái
                  status_url:
                    type: string
                    description: URL truy vấn trạng thái
                refName: PostFalAiNanoBananaResponse
                x-apifox-orders:
                  - cancel_url
                  - logs
                  - metrics
                  - queue_position
                  - request_id
                  - response_url
                  - status
                  - status_url
                x-apidog-orders:
                  - cancel_url
                  - logs
                  - metrics
                  - queue_position
                  - request_id
                  - response_url
                  - status
                  - status_url
              examples:
                example:
                  summary: example
                  value:
                    cancel_url: >-
                      https://queue.fal.run/fal-ai/nano-banana/requests/e7e9202c-efb8-40f2-81c3-13b3f7aaa4ca/cancel
                    logs: []
                    metrics: {}
                    queue_position: 0
                    request_id: e7e9202c-efb8-40f2-81c3-13b3f7aaa4ca
                    response_url: >-
                      Vui lòng dịch nội dung tài liệu kỹ thuật tại URL sau sang
                      tiếng Việt. Giữ nguyên Markdown, mã, định danh, URL, đường
                      dẫn, chỗ giữ chỗ, cấu trúc JSON và định dạng. Chỉ trả về
                      văn bản đã dịch và không để lại bất kỳ chữ Hán nào:


                      https://queue.fal.run/fal-ai/nano-banana/requests/e7e9202c-efb8-40f2-81c3-13b3f7aaa4ca
                    status: IN_QUEUE
                    status_url: >-
                      https://queue.fal.run/fal-ai/nano-banana/requests/e7e9202c-efb8-40f2-81c3-13b3f7aaa4ca/status
          headers: {}
          x-apidog-name: ''
        '400':
          description: Yêu cầu không hợp lệ hoặc xác thực thất bại
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - message
                      - type
                    properties:
                      message:
                        type: string
                        description: Thông báo lỗi (thường kết thúc bằng mã yêu cầu)
                      type:
                        type: string
                        description: Loại lỗi; các lỗi cổng cục bộ thường là new_api_error
                        examples:
                          - new_api_error
                    x-apifox-orders:
                      - message
                      - type
                    x-apidog-orders:
                      - message
                      - type
                refName: NewApiError
                x-apifox-orders:
                  - error
                x-apidog-orders:
                  - error
              examples:
                example:
                  summary: example
                  value:
                    error:
                      message: >-
                        Yêu cầu không hợp lệ (mã yêu cầu:
                        20260805120000123456789AbCdEfGh)
                      type: new_api_error
          headers: {}
          x-apidog-name: Yêu cầu không hợp lệ hoặc xác thực thất bại
      security: []
      x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Fal.ai
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208897-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://api.openaihub.net
    description: Prod Env
security: []

```