Instabooks · GPT 작업

{
  "openapi": "3.0.0",
  "info": {
    "title": "Instabooks API",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://instabooks-ai.fly.dev"
    }
  ],
  "paths": {
    "/generate-book": {
      "post": {
        "summary": "Generate a new book",
        "operationId": "generateBook",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "book_main_title": {
                    "type": "string",
                    "description": "Outline a 12-chapter book for all knowledge levels, offering clear explanations for beginners and advanced theories for experts."
                  },
                  "book_subtitle": {
                    "type": "string",
                    "description": "Craft a concise, catchy book title that's descriptive, engaging, and audience-friendly. It must be memorable, relevant to the content, and distinct within its genre, enticing readers with a clear, intriguing preview of the book's essence."
                  },
                  "book_description_html": {
                    "type": "string",
                    "description": "Craft a persuasive HTML description for the book. Start with a captivating intro, delve into intriguing topics showcasing research depth, relate to readers' interests, highlight practical benefits, and use HTML for clarity. The goal is to convince readers of the book's value."
                  },
                  "book_tags": {
                    "type": "string",
                    "description": "Craft broad, relevant tags for the book covering its themes, subject, and keywords. Avoid niche tags. Make it discoverable and accurately targeted."
                  },
                  "book_seo_title": {
                    "type": "string",
                    "description": "Create an SEO-friendly book title that's concise, descriptive, and reflects the content and author's style to enhance online visibility and engage the target audience."
                  },
                  "book_seo_description": {
                    "type": "string",
                    "description": "Write a concise, SEO-friendly book description (<320 characters) highlighting themes, insights, and keywords. Showcase author expertise and book value for better search results and audience understanding."
                  },
                  "book_hex_color_code": {
                    "type": "string",
                    "description": "Pick a hex code background that complements the subject, suits white text, and avoids light colors. Use"
                  },
                  "book_cover_prompt": {
                    "type": "string",
                    "description": "Draw a simple, colorful illustration (500 characters) representing the subject without text, titles, or signs. Use one or two objects, no 3D or shadows, with a solid background for an elegant, engaging look."
                  },
                  "is_informational": {
                    "type": "boolean",
                    "description": "Exclude keywords related to people, celebrities, brands, media, events, guides, explicit content, advice, numbers, visuals, politics, or offense. Criteria 'true' (informational) or 'false' (non-informational), suitable for a text-based textbook without illustrations."
                  },
                  "keywords_rewrite": {
                    "type": "string",
                    "description": "Rewrite the keywords with more details similar to \"I want to read [something] because of [reason]\". Don't refer to things in quotes."
                  },
                  "book_chapters": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "chapter_title": {
                          "type": "string",
                          "description": "Craft a concise, engaging chapter title that hints at key insights, aligns with the book's style, and invites exploration."
                        },
                        "sections": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "description": "Create 3 concise, clear section titles for each chapter, guiding readers, capturing key points, and maintaining formatting for enhanced comprehension and engagement."
                        }
                      },
                      "required": [
                        "chapter_title",
                        "sections"
                      ]
                    }
                  }
                },
                "required": [
                  "book_main_title",
                  "book_subtitle",
                  "book_description_html",
                  "book_tags",
                  "book_seo_title",
                  "book_seo_description",
                  "book_chapters",
                  "book_cover_prompt",
                  "book_hex_color_code",
                  "is_informational",
                  "keywords_rewrite"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Book is now ready!",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "book_cover_image_link": {
                      "type": "string",
                      "description": "A link to the book's cover image."
                    },
                    "book_product_link": {
                      "type": "string",
                      "description": "A link to the product page for the book."
                    },
                    "message": {
                      "type": "string",
                      "description": "A message indicating the status of the request."
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}